Default action view style attributes

Default style presentation attributes apply to default action views (MenuAction and Action classes).

Table 1. Action style attributes
Attribute Description GDC CLIENT HTML5 CLIENT
scaleIcon Defines the scaling behaviors of the associated icon.

Independently of the style value, the source image is never upscaled to avoid pixelization or blurring of the image. The exception is when the image come from an SVG file which can be upscaled without any penalty. If the icon must be enlarged, the image is centered and a transparent border is added to "fill" the empty space. This allows a mix of larger and smaller icons while keeping widget alignment.

If scaling takes place, the aspect ratio of the original image is kept. A non-square source image displays as a non-square scaled icon.

Values can be:
  • "no": No scaling occurs and the image is taken as-is. It is up to the developer to resize the source image to avoid misalignment.
  • "yes": Image are scaled down according to the height of the button. Setting a big font can result in a big icon.
  • "nnnpx": Image are scaled down according to the specified size. For example, scaleIcon="128px" will make every icon a maximum of 128*128 pixels. At least one side equal to 128 pixels, depending if the source image is square or not.
By default, if the attribute is not defined, the image is scaled down to match a fixed value of 16*16 pixels.
Yes Yes