Skip to main content

Tile widget

A tile widget allows you to repeat the same template for multiple cases in a dataset. For example, you can use a tile widget to display a catalog of products or services or to create a custom table.

A tile widget displaying images and other details from F1 race cases

You can combine a tile widget with a form search widget to allow users to search and filter the cases that are displayed in the tiles.

You can also use a tile widget as the master widget for an activity, casedata, plugin, template, or view widget. When a user selects a case from the tile widget, the case ID is used to populate the second widget. This is useful if you want to display additional information about the selected case or allow users to make changes to the selected case.

Before adding a tile widget to a view, identify or configure the dataset containing the cases that you want to display. For more information, see Configure datasets.

Configure the template that you want to repeat for each case from the Tile Widget properties pane. You can construct the template using plain text or use HTML to customize the layout and include visual elements such as buttons and images. To use a saved template, add the template. function and then select the saved template. For more information, see Templates.

Select the dataset that identifies the cases you want to display in the tiles and configure other options as required:

  • Items per page: Enter a whole number to paginate the results.
  • Master widget: Select a form search widget to allow users to filter the cases that are displayed. Select a grid widget to require users to select one or more items in the grid in order to display further details as tiles.
  • Template on empty: If you have linked a form search widget and the user's search parameters return no results, or a grid widget and the user has not selected an item, the tile widget is not displayed. To display a message in these situations, select a template.
Note:

Although you can achieve the same output as a tile widget by creating a template with an iterator function, we recommend using a tile widget as this requires less code.