Add a List Widget

About this task

Use the List widget to display the list of records submitted or synched by the app user.

Procedure

  1. In the Canvas, open the Widgets tab.
  2. Double-click or drag and drop the List widget onto the app canvas.
  3. In the List Properties panel, enter a name for the widget in the Name field.
  4. Select the form where the data that populates the list will be pulled from.
  5. Choose which fields from the selected form to display.
  6. Enable Modify Records to allow app users to edit the records. Choose which screen app users should be sent to when they click a record to edit it.
  7. Enable Remove records to allow app users to delete the records.
  8. Enable Sort records to allow app users to reorganize the order of the records.
  9. Use the Records per Page slider or field to control the number of records to be displayed per page.
    1. Select Allow Device Users to Modify to enable users to modify the records per page they are able to see.
  10. Select the pagination navigation style.
  11. Select the position of the navigation menu for record pages.
  12. Optional: Add a visibility rule to the widget.
    Use visibility rules to control when a widget is visible to the app user. For example, you can create a condition that a widget should only appear after the app user fills in a field or submits a form.
    1. Select Visibility Rule to open the Set Visibility Rule dialog box.
    2. Select whether the visibility rule requires meeting all or any conditions.
    3. Select an app field or variable and an operator from the Field list. Enter the value required for the widget to be visible.
    4. Select Add Condition to add another condition.
    5. Select Save.
  13. Move to the Format tab to customize the widget's appearance.
  14. Select Save in the SOTI Snap banner to apply your changes.
    Save app button

Results

Tip: Select Preview to see how the widget appears in your app.