Add a List Page

Last updated 8/04/2024

When you add a List page type, a list of records will be displayed for the selected referenced form action. A saved record can be edited by selecting the record in the list and a new record can be added by clicking the Add button. Effectively, the list is displayed first and then the form.

tip

There are three types of lists in Five!

To add a list page to a form, the form you need to reference must be saved in Five. For the most part, the reference form may not have a menu item created unless it is being used for something else.

All the fields that you flag as include in list on the referenced form will be displayed on the page when a user clicks the tab, or scrolls to when on a continuous form.

Let's take a look at an example. In the image below you can see three fields are flagged to be in the list when adding the Address form via the Form Wizard.

Figure 1 - Address form fields included in the list

The Restaurant form has a list page that references the Address form.

Figure 2 - Addresses page on the Restaurant form

In the application, the Restaurant form has the Addresses list page.

info

You may notice here that we had the Restaurant field included in the list back in Five, however, it is not in the list here. Five automatically handles the stack in some use cases so elements are not repeated. In this case, Five knows what restaurant has these addresses because you have selected the restaurant so it is removed from the list.

Figure 3 - Addresses page on the Restaurant form

Add a List Page Type

info

The steps below will demonstrate adding a list page as the second page on a form that already has a form page. You can add a list page as the first page, however, you will still need to add a form page on your form before saving, as your form can't be saved without at least one field.

1. Select the form record you want to add a list page to and click the Pages tab.

Figure 4 - Pages tab

2. Click the Add Pages button.

Figure 5 - Add Pages button

3. Give your page a caption in the Caption field.

4. Select List in the Page Type field.

info

The Action field will now be available for you to select a form to reference.

5. Select the required form in the Action field.

Figure 6 - Add a list page

6. Click the Save button in the form app bar.

Figure 7 - Save button

7. Click the Save button in the form app bar above the list.

Figure 8 - Save button

How This Works in an Application

Firstly, you will need to select the menu item holding your form and select a record. Now click the tab holding your list for the list to be displayed with the included fields.

Figure 9 - List page

You can see the details for a record by selecting the record in the list.

Figure 10 - Record

You can add a new record to the list by clicking the Add button.

Figure 11 - Add button