Form Builder ~ Repeated Grids
Home ▸ Form Builder
Form Builder supports grids with repeated rows. You can repeat a single row (which is the most common case), or multiple heterogeneous (that is with different controls) rows.
You insert a new repeated grid with the "New Repeated Grid" toolbox button.
Once the grid is inserted, you can add and remove (using the grid arrow and trash icons which appear on mouseover) columns and rows, and add controls to grid cells as you would in a regular non-repeated grid.
With only one row, the control labels are used as column headers and are not repeated within the grid. That single row is repeatable with the "plus" icon.
You can add multiple heterogeneous rows with the arrow icons. In this case the entire group of rows is repeatable. Control labels do not appear as column headers, but appear alongside the controls in the grid.
Whether there is a single or multiple repeatable rows, you can add and remove repetitions (iterations) of those rows with the "plus" icon. You typically let the user add iterations at runtime, but it is possible to create iterations in advance at design time as well.
At runtime, notice how in the first grid a single row is repeated, and in the second grid the two rows are repeated.
Once a grid is inserted, you can edit its properties with the "Grid Settings" icon.
The "Visibility" and "Read-Only" formulas control whether the entire grid (including it's headers if any) is visible at all or whether its content is entirely readonly.
NOTE: Since Orbeon Forms 4.8, these settings properly apply to the entire grid. Previously, the grid's repeat headers did not hide properly for example when the grid was hidden. See issue #635.
The repeat settings control whether to use a custom iteration name (not recommended in most cases), and the minimum/maximum number of repeat iterations allowed.
- Support for repeats lands in Form Builder: older blog post
- Inserting and reordering grid rows: blog post
- Repeated sections: blog post