Free cookie consent management tool by TermsFeed

a!sectionLayout_17r1 Component

This page contains information related to an old version of the Section Layout Component.

To take advantage of the latest features and improvements, we always recommend you use the latest version whenever possible. See the latest version's page for information about what's been changed.

Section layout component

Function: a!sectionLayout_17r1()

Displays one or two columns of related components beneath a section title on an interface.

See also: Dashboard, Form

Parameters

Name Keyword Type Description
Label label Text Optional text to display as the section's title.
Column 1 Contents firstColumnContents Any Type Array Values that define the contents for the first column in the interface.
Column 2 Contents secondColumnContents Any Type Array Values that define the contents for the second column in the interface.
Validations validations Text or Validation Message Array Validation errors displayed below the section title. Configured using a text array or an array with a mix of text and Validation Message using a!validationMessage(message, validateAfter).
Validation Group validationGroup Text When present, the section is only validated when a button in the same validation group is clicked.
Collapsible isCollapsible Boolean Determines if an expand/collapse control appears in the section label. Default is false.
Initially Collapsed isInitiallyCollapsed Boolean Determines if the section is collapsed when the interface first loads. Default is false.
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

  • If you put a two-column section within a column of a two-column dashboard, the section's columns collapse into one.
  • If the Column 2 Contents argument is null, the content for the first column displays as in a single-column layout with no space left for where the second column would display.
  • Sections that contain validation messages are not collapsible regardless of the setting of the Collapsible parameter. For example, if a validation is triggered when the form loads, then that section is expanded, even if you have specified true for the Initially Collapsed parameter.
  • If you have nested section layouts, any validations on an inner section will appear in the outer section.

Examples

To experiment with examples, copy and paste the expression into an interface object.

Two columns within a section

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

a!sectionLayout_17r1(
  label: "Customers for Review",
  firstColumnContents: {
    a!textField(
      label: "Customer",
      value: "John Smith",
      readOnly: true
    ),
    a!textField(
      label: "Status",
      value: "Prospective",
      readOnly: true
    ),
    a!textField(
      label: "Priority",
      value: "High",
      readOnly: true
    )
  },
  secondColumnContents: {
    a!textField(
      label: "Customer",
      value: "Michael Johnson",
      readOnly: true
    ),
    a!textField(
      label: "Status",
      value: "Prospective",
      readOnly: true
    ),
    a!textField(
      label: "Priority",
      value: "Medium",
      readOnly: true
    )
  }
)

Displays the following:

screenshot of two columns layouts within a section

Feature compatibility

The table below lists this component's compatibility with various features in Appian.
Feature Compatibility Note
Portals Compatible
Offline Mobile Compatible
Sync-Time Custom Record Fields Incompatible
Real-Time Custom Record Fields Incompatible

Custom record fields that evaluate in real time must be configured using one or more Custom Field functions.
Process Reports Incompatible

Cannot be used to configure a process report.
Process Events Incompatible

Cannot be used to configure a process event node, such as a start event or timer event.

Feedback