Applies to:

  • Winshuttle Foundation

Group properties overview

Related topics

The following table describes the various Group Properties that can be set for Winshuttle Composer form groups.

Group property

Description

Name

The (internal) name of the group as seen and/or referenced by the form and elements in the form.

Label

The 'name' for the group that the form user sees.

Translation Overrides

Click to give the group a label that will override automatic translations.

Read Only

  • True: Contents of the group Read Only.
  • False: Enables the user to change data in the group.

Show Sub-labels

  • True: Shows the sub-label for the group.
  • False: Hides the sub-label.

Columns

The number of columns (1-6) for the group

Show Header

  • True: Shows the header text for the group.
  • False: Hides the header text.

Is Visible

  • True: Makes the group visible.
  • False: Hides the group.
  • Header Only: Does not render the Group content but shows the header and a collapse/expand icon to the form user.

Tip: Setting this to False will hide the Group when the Form is loaded, and can improve performance if there are a large number of groups in the form.

To show a Group that is hidden by default (Is Visible = False), you can use an Action Rule to Change Group Display to Show, and then trigger the rule based on whatever logic is appropriate to your form.

Collapsible

  • True: Makes the Group collapsible in the form.
  • False: Displays the group (always).

Collapsible Field Reference

This option enables you to associate a boolean field (i.e. logical expression) to manage the Collapse/Expand function for a group and preserve its state when the form is reloaded. You can set this manually or through a Set Value rule action.

For example: A group of attributes may only be applicable if creating a new material: so you have a Boolean field (NewMaterial) which appears as a checkbox and when this is checked, the group is expanded, when it's not the group is collapsed. When the form is saved and re-loaded the state of this form (including whether or not it’s a new material) is preserved as is the collapse/expand state of that group.

Label Width

The width of the label for the group.

Border Width

The thickness of the border around the group.

Label Style

The line style for the border around the group (dashed, dotted, solid, etc.)

Border Color

The color of the border around the group.

Background Color

The background color for the group.