Skip to content

Form Builder ~ Repeated Grids

ebruchez edited this page Dec 3, 2014 · 15 revisions

Home ▸ Form Builder

Introduction

Form Builder supports grids with repeated rows. You can repeat a single row (which is the most common case), or multiple rows.

Creating a repeated grid

You insert a new repeated grid with the "New Repeated Grid" toolbox button.

Once the grid is inserted, you can add (using the grid arrow icons which appear on mouseover) and remove (using the trash icon which appears 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.

Repeating a single row

If you add multiple rows with the arrow icons, the entire group of rows is repeated. Control labels do not appear as column headers, but appear alongside the controls in the grid.

Repeating multiple rows

How things look at runtime

At runtime, notice how in the first grid a single row is repeated, and in the second grid the two rows are repeated.

Repeated grids

Grid settings

Once a grid is inserted, you can edit its properties with the "Grid Settings" icon.

Grid Settings

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.

Grid Settings

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.

Grid Settings

See also

Clone this wiki locally