Repeater mode

Repeater mode is more complex than column and row modes. It can be thought of as an advanced form of column.

It should be used if you need to display a list with a variable number of elements (so you do not know the amount at the time of building the form).

Group elements in repeater mode can receive an array (often during the data initializer callback execution) and display as many rows of components as items in the list.

Example

This form contains a group element with ID users, in Repeater mode. Inside the group element, we place a text component with ID name.

In the preview, it renders nothing:

This is because, by default, the form model is empty, and there’s no array with the key users, which is the key assigned to the group repeater.

Now, if we have the following object:

{"users":
  [
    {
      "name": "John Doe"
    },
    {
      "name": "Jane Doe"
    }
  ]
}

and we map it to the form model, we would display something which looks like we added two texts with Column mode and a text inside.

Note

This is currently not possible to preview, as you need to use callback mapping to accomplish this.