Repeat settings

Search…
Repeat settings
Overview
Form Builder supports grids and sections with repeated content.
With grids, you can repeat a single row (which is the most common case), or multiple heterogeneous rows (with different controls).
With sections, you can repeat the entire content of the section a number of times.
Both repeated grids and repeated sections have repeat settings in the "Section/Grids Settings" dialog's "Repeated Content" tab.
Repeated Content
Repeat Content
Select this checkbox to enable repeated content. This enables a series of detailed options below in the same dialog.
Allow the user to add, remove, or move repetitions
[SINCE Orbeon Forms 2019.1]
By default, the form user is allowed to add, remove, or move repetitions. To disable this behavior, deselect the "Allow the user to add, remove, or move repetitions" option. When the checkbox is deselected, the user does not have direct access to buttons, icons or menus to change repetitions.
Allow the user to add, remove, or move repetitions
When this option is deselected, the minimum, maximum and frozen repetitions settings do not apply.
Deselecting this option makes sense in particular when the number of repetitions:
is defined at design-time,
is controlled via actions,
or is controlled via synchronization.
Show repetition number
[SINCE Orbeon Forms 2021.1]
For grids only, selecting this option automatically shows a row number at the beginning of each grid repetition.
Show repetition number
This is how the repetition number appears at runtime.
Repetition number at runtime
Minimum and maximum number of repetitions
These settings can be predefined numbers or formulas when selecting "Other". Here is an example of using a firmula for the maximum number of repetitions.
Formula for the maximum number of repetitions
Freeze repetitions
[SINCE Orbeon Forms 2018.2]
This setting can be a predefined number or a formula.
This allows freezing the first N iterations of a repeated grid or repeated section. Frozen iterations cannot be removed or moved by the user. The grid menus and buttons reflect that those operations are not possible.
The number of frozen iterations must be at most the minimal number of repetitions. If that's not the case, the number of frozen iterations will be reset to the minimal number of repetitions.
See also Freezing rows in repeated grids or sections.
Simplified appearance
[SINCE Orbeon Forms 2019.1]
When selected, this enables a simplified appearance for a repeated grid or section.
The default is the "full" appearance, which features:
visible borders
menus for inserting, removing, and moving rows
When enabled, the simplified (or "minimal") appearance features:
no visible borders
no ability to insert a new row at a specific position
no ability to reorder rows
simple buttons/icons to add/remove rows
Before Orbeon Forms 2019.1, the simplified appearance was available but only controllable via a property. See Appearance of repeated grids and Appearance of repeated sections.
Initial value formulas
[SINCE Orbeon Forms 2016.1]
The "Apply initial value formulas when adding iterations" option specifies whether the "Initial Value" formulas for controls within the grid are evaluated for new iterations.
With the option enabled, new iterations can have dynamic initial values:
Initial Values
With Orbeon Forms 2016.1, the option is enabled by default for new forms and new repeated grids. The option is disabled by default for grids created with previous versions of Orbeon Forms.
Initial number of iterations uses template
[SINCE Orbeon Forms 2016.1]
The "Initial Number of Iterations Uses Template" option specifies, when an enclosing repeated section creates a new iteration, how many iterations this repeated grid will contain:
when enabled: the number of iterations shown in Form Builder (which can be no iterations at all, one iteration, two iterations, etc.)
when disabled: exactly one iteration
The following screenshot shows a case with a repeated grid within nested repeated sections. At first, when the form shows, there are two iterations of the repeated grid.
With the option enabled on the grid, adding a new iteration of Repeated section 2 causes the new iteration to contain a new repeated grid with two iterations:
While, with the option disabled on the grid, adding a new iteration of Repeated section 2 causes the new iteration to contain a new repeated grid a single iterations:
Show one repetition at a time in the wizard
[SINCE Orbeon Forms 2019.1]
This option can be selected only when the "Allow the user to add, remove, or move repetitions" option is deselected.
For details, see Paging large repeated sections.
See also
​Repeated grids​
​Section settings​
​Grid component​
​Section component​
​Paging large repeated sections​
Support for repeats lands in Form Builder: older blog post​
Inserting and reordering grid rows: blog post​
Repeated sections: blog post​
Repeated grids and sections just got more subtle: blog post​
Freezing rows in repeated grids or sections: blog post​
Quick control search
Repeated grids
Last modified 1yr ago
Copy link
On this page
Overview
Repeat Content
Allow the user to add, remove, or move repetitions
Show repetition number
Minimum and maximum number of repetitions
Freeze repetitions
Simplified appearance
Initial value formulas
Initial number of iterations uses template
Show one repetition at a time in the wizard