Section Headings are typically used to add a title to a group of fields. They may also be used to customize your form layout or conditionally hide/show groups of fields. Sections may be collapsible or repeatable. The repeatable option allows users to add a group of fields any number of times.
Standard Field Options
A Section Heading field has the following standard options.
Field-specific options
Collapsible
If you would like your section or repeater to slide open or closed, you can select the Collapsible checkbox option.
To learn more about collapsible sections, click here.
Display Section Heading
Display the value submitted in a Section Heading in a form's confirmation message, email, or View. You can find the section heading ID in your form builder.
Shortcode options
- Display label: Display the section heading field label.
[x show=field_label]
Replace x with the ID or key of the Section Heading field.
Section styling
Customize the style of your Section Headings by going to 'Formidable' → 'Styles' → 'Section Fields'. The styling in the Headings tab will apply to repeatable and collapsible headings as well.
Create a section
- Click on the Section field.
- Drag and drop the field(s) that you would like into the section.
Conditionally hide/show section
Conditionally hide or show sections of your form by adding conditional logic to a Section. When you add conditional logic to a Section Heading, the conditional logic will apply to all fields in that section.
This feature is a great time-saver because you only need to add conditional logic to the Section Heading and not to every field in the section. If you do not want the Section Heading to be visible in your form, set the Label Position to hidden or none.
Form layout
Use Sections to design the layout of your form. When you add a CSS layout class to a Section field, the class will apply to all fields in that section. You can also add styling to individual fields in the Section; just insert the class into the field's 'CSS layout classes' box.
Section Headings provide a faster and easier way of putting your form into columns. If you want a two column form, for example, you only need to add CSS layout classes to two sections, rather than adding a class to every field in the column.
If you want to use a Section for styling purposes, but you do not want the Section Heading text to be visible in your form, set the 'Label Position' to hidden or none.
Limitation
A repeater field cannot be added inside a section field. This functionality is not currently supported.
Related developer hooks
- Always open sections with the frm_section_is_open hook.
- Open a target field with the frm_section_is_open hook.
- Open all sections in a target form with the frm_section_is_open hook.
