Definition
MeltingGroup acts like a container and layout at the same time. It can only contain certain items (mainly single-line UI elements like input fields) and arranges them horizontally, without wrapping. The (relative or absolute) width of the individual items, as well as their separation, can be adjusted by means of melting group data.
MeltingGroup allows you to put several elements (MeltingGroupItem) into one cell of the ColumnLayout or into one table cell. Typically, they can be used to place a combination of input field and text view into a single cell.
MeltingGroups are created to combine elements with a height of one line only (InputFields, TextViews, CheckBoxes etc.). If other elements are used in a MeltingGroup, they will push the height of the line. This may produce undesired results. The MeltingGroup itself uses 100% of the available space of its parent container
If several Melting Groups are used within a form, their content is not aligned with the content of the otherMelting Groups by default.
The distance between the individual elements is defined using an “Item Separation” attribute. The default value for this attribute is 3 pixels. In order to allow different spacing, each item in the Melting Group can define a different separation using the following values: default, small, medium, large, small with line, medium with line, large with line (see graphic below).
Melting Groups in a table need a special Item Separation, because input fields in tables do not have borders. The value for this will be “Table Separation” (7 pixels with separator). (See graphic below)
As shown in the graphic below, the individual Melting Group Items can be sized relative in percent or in characters and pixels.
Description of UI Element Properties
● accessibilityDescription
When accessibility is activated, the assigned text is added to the tooltip. This description provides semantic details of the UI element and is only read by the screen reader if the user focuses the complete Ul element.
Name |
Interface |
Type |
Initial Value |
Bindable |
accessibilityDescription |
IWDMeltingGroup |
String (Translatable Text) |
|
bindable |
Enabled |
IWDUIElement |
boolean |
true |
bindable |
Tooltip |
IWDUIElement |
String (TranslatableText) |
|
bindable |
Visible |
IWDUIElement |
WDVisibility |
visible |
bindable |