Action views on mobile devices

Action views are rendered following mobile specific standards.

Action view rendering on mobile

The top and/or bottom part of the app screen can be used to place action views (UI button controls).

Key functions of these areas:
  • Make important actions prominent and accessible in a predictable way (such as New or Search).
  • Support consistent navigation and view switching within apps.
  • Reduce clutter by providing an action overflow for less-used actions.
  • Provide a dedicated space for giving your app an identity with text and/or an image.
How actions are rendered on the mobile device depends on:
  • The order of the ON ACTION statements in the current dialog of the running app.
  • The type of platform (Android™/iOS).
  • The type (phone/tablet) and orientation of the device.
Actions are mapped to the Android or iOS platform in a specific way, following the platform standard.

Actions can be programmatically enabled and disabled, and hidden and shown.

The text, image and other properties of the action can be controlled with action attributes.

GUI elements to trigger actions on mobile devices

Each mobile platform provides its own standard to display action triggers.

GMA and GMI follow respectively the Android and iOS standards:

Decorating action views on mobile

Actions are typically decorated using the IMAGE or the TEXT action attribute. If these attributes are not defined or if the specified image resource is not available, the mobile front-end uses a default decoration. For some actions, the front-end always uses the platform-specific decoration. For example, on iOS devices, the "refresh" action always renders as a typical circular arrow icon.

Well-known actions use a default icon or text corresponding to the mobile platform GUI guidelines. As these follow the mobile OS standards, do not define your own text or icons for common actions such as "accept" or "cancel".

For a complete list of predefined action decorations, see:

Rendering close/cancel/accept actions on Android devices

The physical back button on an Android device is considered a default action view for the "close", "cancel", or "accept" action in the current dialog:
  • If a close action is defined, it is assigned to the back button.
  • If the close action is not defined, but the cancel action is defined, it is assigned to the back button.
  • If neither close nor cancel actions are defined, but the accept action is defined, it is assigned to the back button.

If accept or cancel cannot be assigned to the back button, a default action view appears in the action panel. For example, if all three actions (close, cancel and accept) exist and are active, the action panel shows a check mark for the accept action and a cross icon for the cancel action, while the back button fires the close action.

Default action views rendering with MENU

On mobile devices, the rendering of the MENU dialog depends on whether or not the current window has a form.

If a MENU is active and the current Window has no form, then the MENU is shown as a list of actions.

If a MENU is active and has a FORM, then the menu actions are rendered like all other dialog actions.