Default action view style attributes

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

Note: This topic lists presentation style attributes for a specific class of form element, common presentation style attributes can also be used for this type of element.
Table 1. Action style attributes
Attribute GDC GWC-JS GMA GMI

androidActionPosition

On Androidâ„¢, defines if the option corresponding to the action must be displayed in the menu bar.

Values can be:
  • "button": The action view will be displayed in the Android action bar as a button, if there is no room in the action bar, the action view is not displayed.
  • "overflow": The action view will be displayed in the Android action bar overflow dropdown list.
  • "default": The action view will be displayed in the Android action bar, or in the overflow dropdown, if there is no room in the action bar.
N/A N/A Yes N/A

androidActionWithIcon

On Android, defines if the icon (default icon or icon specified with the IMAGE attribute) must be displayed for the action view.

Values can be:
  • "yes" (default): The icon is visible (default).
  • "no": The icon is not shown.
N/A N/A Yes N/A

androidActionWithText

On Android, defines if a label (specified with the TEXT attribute) must be displayed for the action view.

Values can be:
  • "yes" (default): Option text is visible (if there is an icon)
  • "no": Option text is not shown.
Note: If the device orientation is in portrait mode, Android may not display the text, even if you force it with this attribute.
N/A N/A Yes N/A

scaleIcon

Defines the scaling behaviors of the associated icon, if the source image size is bigger than the place reserved for it in the widget.

Note: On GDC and GWC, if the scaleIcon attribute is undefined, the behavior depends on the kind of action view: toolbar button icons and action panel button icons are scaled down to match the size of the widget. For other widgets, by default no scaling occurs, as for scaleIcon="no".
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. This is the default on GDC/GWC.
  • "yes": Image are scaled down according to the height of the widget (button or edit field). Setting a big font can result in a big icon. This is the default on GMA/GMI.
  • "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.

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.

Yes Yes No No