The Section form element allows you to group form elements into sections.
There are different styles of section:
Collapsible: Contents of Collapsible sections can be shown or hidden by clicking the section header.
Fieldset: Fieldset sections are surrounded by a frame.
Group: Group sections have a bar at the left.
Unstyled: Unstyled sections are not styled in any special way.
In the screen capture below, is a Fieldset section,
is an Unstyled section, and
is a Collapsible section.
Example of two Section form elements, shown in a Geocortex viewer
Sections are useful for organizing a form into conceptually related parts. One of their advantages is that you can hide or show an entire section, including all the section's elements, by changing the section's visibility. This saves you from having to change the visibility of each of the section's elements individually.
When you create a new form, the form contains header () and footer (
) elements. You cannot add elements above the header or below the footer. At the top of the form (below the header), you can have elements that are not in sections. In the screen capture below, the drop-down list (
) and text box (
) are not in sections.
Any sections that you add to a form are below the elements that are not in sections (above the footer). The screen capture below shows two sections, a Group section () that contains a checkbox and a text box, and a Fieldset section (
) that contains an auto complete element and a number element.
To add elements to a section, drag and drop the elements onto the section one at a time.
You cannot nest sections.
Form with sections shown in Workflow Designer (left) and in the Geocortex Viewer for HTML5
The Properties table describes the properties of the
Property names in Workflow Designer's Properties panel are written using the capitalization and spacing of a title. Property names in expressions are valid JavaScript identifiers and start with a lower case letter. Expressions are case sensitive. When you access a form element property in an expression, you must use the correct capitalization.
In the table below:
If a property can be accessed in both the Properties panel and expressions, then the table gives both versions of the name.
If a property's name in the table starts with a lower case letter, then you can only access the property in expressions.
If a property's name starts with a capital letter and the table does not give a name to use in expressions, then you can only access the property in the Properties panel.
Properties of the Section Form Element
Collapsed |
Type: Boolean Name in Properties Panel: Collapsed Name to Use in Expressions: collapsed
This property is visible only when Style is set to
Indicates whether the section is collapsed. When To access the ${Display Form ID}.state.{Element ID}.collapsed For example: $form1.state.section1.collapsed |
Description |
Type: String A description of the element. The description appears below the element's title. You can use the Description property to describe what the element represents or to provide instructions to the user about how to use the element. You can format the description using Markdown. |
Element ID |
Type: String The element's ID, which is used in other form elements and activities to access the element's properties. The ID must be unique across all elements in the form. You cannot get or set the value of the Element ID property in an expression—you can only use the value that you configured for it. To use the Element ID property in an expression: ${Display Form ID}.state.{Element ID}.{property name} For example: $form1.state.section1.visible |
The style for presenting the section. The possible styles are listed below. In Workflow Designer, the different styles are indicated by different colored bars at the left.
|
styleName |
Type: String
Indicates the name of the style that will be applied to the element. To access the ${Display Form ID}.state.{Element ID}.styleName For example: $form1.state. |
Title |
Type: String The element's title, which appears at the top of the element. You can format the title using Markdown. |
type |
Type: String The variety of form element. Use the To access the ${Display Form ID}.state.{Element ID}.type For example: $form1.state.section1.type |
Visible |
Type: Boolean Name in Properties Panel: Visible Name to Use in Expressions: visible Indicates whether the element is visible to the user. By default, Hiding a section also hides the elements in the section. When a section is visible, you can hide individual elements in the section by setting the individual element's Visible property to To access the ${Display Form ID}.state.{Element ID}.visible For example: $form1.state.section1.visible |
The following table describes the events associated with the
Events for the Section Form Element
load |
The You can use the |