Form Widget
Groups a set of input widgets sharing the same validation context. A common usage for this widget is to group the several inputs of an Entity or Structure record in a screen to create or update that record.
The layout of this widget is flexible, allowing you to organize the widgets inside the way you need.
All enabled inputs inside the form will have the following behaviors:
- When the mouse hovers over the input, an icon appears inside the input indicating that the value is editable;
- After changing a value in one input, an undo action becomes available allowing the end-user to revert the value to the original one.
Properties
| Name | Description | Mandatory | Default value | Observations |
|---|---|---|---|---|
| Name | Identifies an element in the scope where it is defined, like a screen, action, or module. | Yes | ||
| Source Record | Specifies a record to populate the widget. | Yes | ||
| Width | Width of the widget in columns. Other accepted units are pixels(px), points(pt), or percentage(%). Overrides the style sheet definition. | |||
| Margin Left | Left margin of the widget in columns. Other accepted units are pixels(px), points(pt), or percentage(%). Overrides the style sheet definition. | |||
| Margin Top | Top margin of the widget in pixels. Other accepted units are points(pt) or percentage(%). Overrides the style sheet definition. | |||
| Label Position | Specifies the relative position of the labels in the form. | Yes | Left Aligned | |
| Style Classes | Specifies one or more style classes to apply to the widget. Separate multiple values with spaces. | Form | ||
| Enabled | Boolean literal or expression that defines if the widget is editable. | Yes | True | |
| Extended Properties | ||||
| Property | Name of an attribute to add to the HTML translation for this element. | You can pick a property from the drop-down list or type a free text. The name of the property will not be validated by the platform. Duplicated properties are not allowed. Spaces, " or ' are also not allowed. |
||
| Value | Value of the attribute. | You can type the value directly or write expressions using the Expression Editor. If the Value is empty, the corresponding HTML tag is created as property="property". For example, the nowrap property does not require a value, therefore nowrap="nowrap" is added. |
||
Runtime Properties
| Name | Description | Read Only | Type | Observations |
|---|---|---|---|---|
| Id | Identifies the widget instance at runtime (HTML 'id' attribute). You can use it in JavaScript and Extended Properties. | Yes | Text | |
| Record | Current record being edited in the widget. | Record | ||
| Valid | False when the Valid runtime property of one or more widgets grouped by the Form is False. | Yes | Boolean |