Section
- collapsible section content
- optional repetition of its content
- configurable min/max number of iterations
- can repeat over several heterogeneous rows
- built-in icons and menus to add, remove, and move repeated rows
An open, collapsible section shows a "collapse" icon at the left of the heading.

Open section
The same section when closed just shows the heading.

Closed or collapsed section
A menu is available to perform operations on or around a line. Not all operations are always available, depending on the position of the line or the
freeze
setting. When the entire grid is made readonly, the menu is not present.- Insert Above
- When allowed, insert a new repetition above the current one.
- Insert Below
- When allowed, insert a new repetition below the current one.
- Move Up
- When allowed, move the current repetition one level above.
- Move Down
- When allowed, move the current repetition one level below.
- Clear Line
- [SINCE Orbeon Forms 2019.2]
- Clear or reset all the values in the current repetition.
- Remove Line
- When allowed, remove the current repetition.

Repeated section menu

Full appearance
[SINCE Orbeon Forms 2016.1]

Minimal appearance
These attributes are supported when the section is in non-repeated mode.
open
- whether the section is initially open
true
(default)- section is initially open
false
- section is initially closed
- NOTE: When the Form Runner mode is readonly ("view" mode, "pdf" mode, etc.),
open
is forced totrue
.
animate
- whether the section animates when collapsing/expanding
true
(default)- section animates
false
- section does not animate
collapsible
[SINCE Orbeon Forms 2016.1]- whether the section can be collapsed and expanded by clicking on its title
true
(default)- allow section to be collapsed
false
- don't allow section to be collapsed
- NOTE: If the section is initially closed and
collapsible
isfalse
, the user won't be able to open the section.
level
[SINCE Orbeon Forms 2016.3]- level of the section, from
1
to6
- default:
2
- alongside
base-level
, this value translates into an HTML headingh1
toh6
base-level
[SINCE Orbeon Forms 2016.3]- base level of the section, from
0
to5
- default:
0
- when set to a non-zero value, this value is added to the value of
level
to produce the actual section level
These attributes are supported in addition to the non-repeated mode attributes when the section is in repeated mode:
freeze
- optional number of rows at the top which cannot be removed or moved
- can be an AVT [SINCE Orbeon Forms 2016.3]
readonly
- whether to disallow the user to add/remove iteration with the menu or the "-" button (depending on appearance)
false
(default)- show the iteration menu and buttons, unless the section binds to a readonly node or unless the Form Runnermode is readonly ("view" mode, "pdf" mode, etc.)
true
(default)- don't show the iteration menu and buttons
appearance
[SINCE Orbeon Forms 2016.1]full
- the default appearance, as with Orbeon Forms 4.10 and earlier
- iteration menu
- reordering of iterations
- insertion of iterations at specific points
- removing of specific iterations
minimal
- does not show the "+" button at the top left
- does not show the iteration menu and associated features
- instead just provides "Add another" and "Remove" links at the bottom and a "-" button to the right
insert
[SINCE Orbeon Forms 2016.2]index
- the "Add Another" or "+" button adds a new repetition after the iteration currently with keyboard focus
- this is the default in
full
appearance
bottom
- the "Add Another" or "+" button adds a new repetition after the last iteration
- this is the default in
minimal
appearance
You move, insert, and remove iterations using the left menu:

Menu
Event name | Description |
fr-expand | Expand the section |
fr-collapse | Collapse the section |
[SINCE Orbeon Forms 2016.1]
The following events are dispatched to the
fr:section
element:Event name | Description |
fr-iteration-added | Dispatched when the user has just added an iteration |
fr-iteration-removed | Dispatched when the user has just removed an iteration |
These events are not dispatched if the number of iterations changes by other means, for examle if the data is replaced, or inserts/deletes happen outside of the component.
Last modified 3yr ago