Button Layout

Button Layout

Function: a!buttonLayout()

Displays a list of buttons grouped by prominence. Use this layout in cases where prominence needs to be explicitly specified.

Parameters

Name Keyword Types Description

Primary Buttons

primaryButtons

List of ButtonWidget

Array of prominent buttons created with a!buttonWidget().

Secondary Buttons

secondaryButtons

List of ButtonWidget

Array of less prominent buttons created with a!buttonWidget().

Accessibility Text

accessibilityText

Text

Additional text to be announced by screen readers. Used only for accessibility; produces no visible change.

Visibility

showWhen

Boolean

Determines whether the layout is displayed on the interface. When set to false, the layout is hidden and is not evaluated. Default: true.

Notes

  • For web and mobile tablets, buttons display in a horizontal list. The most prominent buttons appear at the far right and the least prominent buttons appear at the far left.
  • For mobile phones, buttons display in a vertical line. The most prominent buttons appear at the top and the least prominent buttons appear at the bottom.
  • For the primaryButtons parameter, the first item in the array is the most prominent. For the secondaryButtons parameter, the first item in the array is the least prominent.

The following patterns include usage of the Button Layout.

FEEDBACK