Skip to main content

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.

tip

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.

Play

βš™οΈ 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.