Button style attributes

Button style presentation attributes apply to a button element.

Table 1. Button style attributes
Attribute Description GDC CLIENT HTML5 CLIENT
buttonType

Defines the rendering of a button.

Values can be:
  • "normal" (default): The button is rendered as a regular push button.
  • "link": the button is rendered as an HTML hyper-link. In contrast to the label hyper-link support, clicking on a "link" button does not start the default browser, but triggers the corresponding action, like a normal button.
  • "commandLink": the button is rendered as a "Command Link" button on Microsoft™ Windows™ Vista and Windows 7.
Yes Yes
scaleIcon Defines the scaling behaviors of the associated icon.

Independently of the style value, if an icon must be scaled, the source image will never be upscaled to avoid as much as possible pixelization or blurring the image. The notable exception is when the image come from an SVG file which can be upscaled or downscaled without any penalty. If the icon must anyway be made bigger, the image will be centered and a transparent border will be added around to "fill" the empty space. It will allow user to mix big icon with smaller one but also to keep widget alignment

If a scaling take place, the aspect ratio of the original image will be kept, keeping non square source as non square scaled icon.

Values can be:
  • "no" (default): No scaling occurs at all, the image are taken "as is". It's up to the user to resize the source image to avoid button misalignment.
  • "yes": Image are scaled down according to the height of the button. Setting a "big" font may result with a "big" icon.
  • "nnnpx": Image are scaled down according to the specified size. For example, scaleIcon="128px" will make every icon to have no more than 128*128 pixels, but at least one side equal to 128 pixels, depending if the source image is square or not.

Yes Yes