How-to guides / Using the repeater

Using the repeater

This guide will dive deeper into how you can make use of the Repeater widget. An important prerequisite to getting started here is that you have looked at our guide to getting started with subject composition. The repeater widget namely allows you to create a container and populate this container with widgets that will be repeated for the children or descendants of the specific subject. In our case, we will build on the previous examples where have a Room subject, that has 2 Temperature sensor subjects as children. The repeater will allow us to define content that will then automatically be repeated, thus when adding more children the repeater will simply display its relevant information automatically.

---

1. Clicking on the arrow next to your subject will expand to show its children

2. As you can see, Room 1A has multiple children of Subject type "Temperature Sensor". Click the row of "Room 1A" to navigate to the subject dashboard of Room 1A.

3. Enter the edit mode of your subject dashboard by clicking here.

4. Add a new panel

5. Select the Repeater from the list

6. Click "Next step"

7. Select the subject type that you would like to repeat. In our case, the floor has multiple Temperature Sensor subject types.

8. Click "Add panel"

9. The added repeater will be displayed as a container. These containers will have their own Add panel button. Please be aware that you must click the Add panel button of the repeater in order to add widgets within the repeater.

10. Now you can add a widget of your choosing. In our case, we will repeat an image of each Temperature Sensor.

11. Click "Next step"

12. Select the "Property value" option.

13. Click "Next step"

14. Fill in a caption of your choosing, here you can make use of tokens. For example, to add the name of the repeated subject, simple type "{{Name}}" and it will be populated once the widget is rendered on the dashboard.

15. We will display the image property within the repeater.

16. Click "Add panel"

17. Congratulations, you've added a repeater with content. You can see that Room 1A has two descendants, or children, each with an image that is automatically repeated. Feel free to add more widgets and test out how they will be repeated. You can also drag and resize the repeater.