Section
What it does
The fr:section
component organizes grids under a header or title. Features:
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
Appearance
Non-repeated appearance
An open, collapsible section shows a "collapse" icon at the left of the heading.
The same section when closed just shows the heading.
Full repeat appearance
Menu
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.
Appearance
Minimal repeat appearance
[SINCE Orbeon Forms 2016.1]
Basic usage
Non-repeated mode
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
Repeated mode
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 Runner
mode 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:
Data format
See Form data format.
Events
Events supported
Events dispatched
[SINCE Orbeon Forms 2016.1]
The following events are dispatched to the fr:section
element:
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.
See also
Last updated