Wizard Component
What it does
The fr:wizard
component presents the nested list of fr:section
elements as a series of navigable steps, with only one section is visible at a time. The component also shows a table of contents and buttons allowing users to navigate between sections.
Basic usage
<fr:wizard>
<fr:section id="personal-data-section">
...
</fr:section>
<fr:section id="comments-section">
...
</fr:section>
</fr:wizard>
sectionref
[SINCE Orbeon Forms 4.8]
The sectionref
attribute allows reading and writing the current section name to instance data.
<fr:wizard sectionref="instance('foo')/bar">
<fr:section id="personal-data-section">
...
When the wizard shows for the first time, the current section value is read from instance data. If it matches one of the section names, the given section is shown first. When the user navigates between sections, the current section name is stored into instance data.
The section name is obtained from the section id by removing its -section
or -control
suffix. So in this example, the value stored will be personal-data
or comments
.
See also
- Form Runner Wizard View: the relevant Form Runner documentation
- Form Runner Wizard View: a blog post which introduces to the feature, with a video