Using bookmarks
Tripetto supports the use of bookmarks to organize and group sections of a form. On the runner side these bookmarks make it possible to implement features like an interactive table of contents of the form content or other ways of (multi-page) form navigation like tabs or wizards.
Bookmarks add an extra dimension to the form builder. They transcend the flowchart approach of the form builder and allow different sections to be visually grouped in the form runner.
👩🏫 How bookmarks work
Its operation is actually quite simple. Once a section is bookmarked, all subsequent sections (that are not bookmarked) are included in it. Whenever a successive section is bookmarked on its own, the previous bookmark closes and the process continues to include successive sections in that new bookmark. Bookmarks transcend branches, and can be set anywhere in the form flowchart. This makes it possible to include sections inside of branches in a bookmark (basically grouping sections across the flowchart). It is also possible to recall values from the form and use it in the bookmark name. This can be very powerful in combination with branch iterations as it allows generating bookmark entries based on selections made by the form respondent.
📺 Preview
Here is a simple form that aks the user to select frameworks/libraries from a list. For each selected item, an additional bookmark is generated and shown in the table of contents of the runner.
📽️ Demo
Play around in this interactive demo. Please click Load example in the demo header to load the example form shown above.
⚙️ API
Bookmarks are set in the form definition using the bookmark, bookmarkName, bookmarkDescription, and bookmarkLevel properties of a section.
On the runner side, the bookmarks property of the Storyline contains the parsed bookmarks of a form.