Components are user interface controls used to render information on screen, and allow the user to edit that data if required. Typical components are a textbox, a checkbox, a radio group, a table, and so on.
The components are defined in a form's definition json, including some common attributes and some component-specific attributes. Most attribute values allow expressions in addition to the type shown in the attribute table.
Common attributes are attributes used by most components.
When we reference common attributes in other parts of the documentation, we are referring to this table:
|id||ID added to the top-most DOM element of the component|
|type||Type expected in the form definition|
|value||Payload attribute to show, usually an expression, e.g. |
|defaultValue||Value to be assigned when the form is loaded with an empty payload|
|description||Text to be rendered after the input as a component description|
|enabled||If false the component will be disabled|
|isRequired||If true the form won't be valid until this component has some value|
|label||Text to be rendered before the input as a component label|
|size||Number of columns to be used in the 12 column row|
|styleClass||Class added to the top-most DOM element of the component|
|visible||If false the component will be hidden (validations still apply)|
|ignore||If true the component will be hidden and the value won't be part of the payload.|
See ignore section below for important notes
|labelAlign||"top": label is place on top of the input, "left": label is at the left of the input|
|tooltip||When it is defined, a question mark icon will appear in the coponent label. When the user hovers over it it will show this text in a tooltip.|
|placeholder||Placeholder text for data entry components|
Some important notes:
valueis required in order to work with ignore.
e.g. panel is often used without a value and ignore wouldn't work
- Ignore overrides
These are component specific attributes, usually found in the
These will be explained in detail for each component.