The Page field is a basic but primary field type needed for any form you create; without it, you cannot add fields to display or capture data in the app.
Essentially, it allows you to group fields to break up data capture across numerous pages, capture repeatable data (hyperlink) when needed, and how validation is controlled for fields on the page.
For example, instead of having an endless vertical scrolling form with, let's say, 100 fields on a single page, you could break it up into five separate pages with 20 fields on each page. Depending on your scenario, this could improve end-user experience when capturing data and navigating the form overall.
In this article
- How to use it?
- Adding Pages
- Navigating Pages
- Reordering Pages
- In-App Navigation
- Properties
Adding Pages
When designing a Data Entry Form, Pages can be added by clicking the Page field type under Basic Fields on the left. Data capture fields can then be added and ordered as needed by dragging and dropping them onto the Page field.
Navigating Pages
The number of pages in a form can initially be seen as dots on a line at the bottom of the design preview or by the adjacent drop-down list. Both are clickable to navigate to a Page and its fields for configuring.
Reordering Pages
When your cursor focuses on a field, additional options display at the top right of the field, with two arrows. Selecting either of these arrows will move the page up or down, i.e., before or after an adjacent page.
Alternatively, you can change the preview's view mode to Continuous to drag and drop pages to reorder them. The Continuous mode option is found on the bottom right of the preview.
In-App Navigation
In-app, there are two options for navigating between pages: using the default navigation arrows found at the top right of the device’s screen when viewing a form or adding Custom Navigation using Action fields.
Properties
| Basic Properties | |
| Data Name | The unique data name of this page/group. |
| Page Title | Give the page a title to display to the user. |
| Repeatable | Allow this page to repeat its fields. |
| Repeat Range | Minimum and/or maximum times this page should be repeated. If the Minimum is set, the app will automatically repeat this Page that number of times. After that, the user will be prompted to add more. Once Maximum repeats is reached, the app will move to the next Page. |
| Prevent Deletion of Repeats | By default, users can delete repeats via a button at the top of each repeatable Page. This option removes the button, preventing repeat deletion. This is useful for cases such as pre-populated and/or fixed repeats. |
| Layout & Styling | |
| Background color | Set the background color of the Title. |
| Validation & Behaviour | |
| Visibility | Control the visibility of this page using a formula. |
Validation Behaviour | Specify how the fields on this Page should be validated. Inline validation occurs immediately after the user has entered a value into a field. Page Change validation occurs when the user tries to navigate to another Page. End of Form validation allows the user to leave this Page while fields are still invalid, and validation checks are only performed when the entry is to be uploaded. |