Orbeon Forms
Search…
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.
Open section
The same section when closed just shows the heading.
Closed or collapsed section

Full repeat appearance

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

Appearance

Full appearance

Minimal repeat appearance

[SINCE Orbeon Forms 2016.1]
Minimal appearance

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 to true.
    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 is false, the user won't be able to open the section.
    level [SINCE Orbeon Forms 2016.3]
      level of the section, from 1 to 6
      default: 2
      alongside base-level, this value translates into an HTML heading h1 to h6
    base-level [SINCE Orbeon Forms 2016.3]
      base level of the section, from 0 to 5
      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:
Menu

Data format

Events

Events supported

Event name
Description
fr-expand
Expand the section
fr-collapse
Collapse the section

Events dispatched

[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.

See also

Last modified 1yr ago