Displays up to two columns of components beneath a title and above buttons. Use this as the top-level layout of start and task forms.
See Also: Dashboard
Function: a!formLayout_17r1()
Parameters
Name | Keyword | Type | Description |
---|---|---|---|
Label | label | Text | Optional text to display as the interface's title. |
Instructions | instructions | Text | Optional text displayed below the field's label. |
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. |
Buttons | buttons | Button Layout | Buttons to display at the bottom of the form, arranged using a!buttonLayout() . |
Validations | validations | Text or Validation Message Array | Validation errors displayed above the form buttons. 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 form is only validated when a button in the same validation group is clicked. |
Don’t automatically focus on first input | skipAutoFocus | Boolean | Determines whether the first input will receive focus when a form 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
Examples
Copy and paste an example into the INTERFACE DEFINITION in EXPRESSION MODE to see it displayed.
Two-Column Form
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
38
39
40
41
42
43
44
45
=a!formLayout_17r1(
label: "Customers for Review",
instructions: "Review the profiles for the customers below and contact as needed",
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
)
},
buttons: a!buttonLayout(
primaryButtons: {
a!buttonWidgetSubmit(
label: "Submit"
)
}
)
)
Displays the following:
On This Page