a!sectionLayout_17r1 Component

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

Old versions do not appear in category lists; only the newest versions are listed.

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

Section 17.1

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.

Notes

  • You can not add a section as the content for another section. It results in an error.
  • 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.

Examples

Copy and paste an example into the INTERFACE DEFINITION in EXPRESSION MODE to see it displayed.

Two-Columns within One 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:

Open in Github Built: Fri, Nov 04, 2022 (07:10:52 PM)

On This Page

FEEDBACK