Button Layout
This SAIL component may not be compatible with all features of Appian. For details, see the Feature Compatibility section below.

Function

a!buttonLayout( primaryButtons, secondaryButtons, accessibilityText, showWhen )

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

See also: Button design guidance

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.

Usage considerations

Using buttons on different devices

  • 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.

Using the primaryButtons and secondaryButtons parameters

  • 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.

Feature compatibility

The table below lists this SAIL component's compatibility with various features in Appian.
Feature Compatibility Note
Portals Compatible
Offline Mobile Compatible
Custom Record Field Expressions Incompatible

The following patterns include usage of the Button Layout.

Open in Github Built: Wed, Aug 10, 2022 (11:20:51 PM)

On This Page

FEEDBACK