Altinn Studio Reference User interface Fields Grouping Repeating

Repeating groups

Setup for repeating groups

Groups in the data model contain one or more fields. In the Layout configuration, a component is configured to be a repeating group by setting the type to "RepeatingGroup". A group that is repeating in the data model must also be set up as repeating in the form, if not, data saving will fail. In JSON, a repeating group is defined as an array of objects, where each object is a group. In XML, a repeating group is defined as a list of elements, where each element is an object with properties.

Example

Below is a form with a repeating group that:

Contains two components (checkbox and address)
Can be repeated up to three times
Is bound to the data model group/array GruppeListe

Vis/skjul innhold Show configuration for this screenshot

 1{
 2  "$schema": "https://altinncdn.no/toolkits/altinn-app-frontend/4/schemas/json/layout/layout.schema.v1.json",
 3  "data": {
 4    "layout": [
 5      {
 6        "id": "gruppe",
 7        "type": "RepeatingGroup",
 8        "children": [
 9          "avkrysningsboks",
10          "adresse"
11        ],
12        "maxCount": 3,
13        "dataModelBindings": {
14          "group": "GruppeListe"
15        }
16      },
17      {
18        "id": "avkrysningsboks",
19        "type": "Checkboxes",
20        "textResourceBindings": {
21          "title": "Avkrysningsboks"
22        },
23        "dataModelBindings": {
24          "simpleBinding": "GruppeListe.Avkrysning"
25        },
26        "options": [
27          {
28            "label": "Navn",
29            "value": "Verdi1"
30          },
31          {
32            "label": "Adresse",
33            "value": "Verdi2"
34          }
35        ],
36        "required": true
37      },
38      {
39        "id": "adresse",
40        "type": "Address",
41        "dataModelBindings": {
42          "address": "GruppeListe.Adresse",
43          "zipCode": "GruppeListe.Postnr",
44          "postPlace": "GruppeListe.Poststed"
45        },
46        "simplified": true,
47        "readOnly": false,
48        "required": true
49      }
50    ]
51  }
52}

Parameters

Parameter	Required	Description
id	Yes	Unique ID, same as ID on other components. Must be unique in the layout file, and should be unique across pages.
type	Yes	Must be ‘RepeatingGroup’
dataModelBindings	No	Must be set for repeating groups with form components inside. Should point to the repeating group in the data model.
textResourceBindings	No	Can be set for repeating groups, see description.
maxCount	No	The number of times a group can repeat.
minCount	No	Validation. The minimum number of times a group must repeat before the user can submit the form.
children	Yes	List of the component IDs that are to be included in the repeating group.
edit	No	Options for how to display the group when editing a row.
tableHeaders	No	List of components that are to be included as part of the table header fields. If not specified, all components are displayed.
tableColumns	No	Object containing column options for specified headers. If not specified, all columns will use default display settings.
stickyHeaders	No	If set to `true`, the table headers will be sticky.

textResourceBindings

It is possible to add different keys in textResourceBindings to overrule default texts.

title - title to show above the group and over each group row in a Summary component.
summaryTitle - If set, overrides title when displaying a Summary component.
description - A description to show above the group beneath the title.
add_button - is added at the end of the “Add new” text on the button, and can be used to e.g. get text that says “Add new person”.
add_button_full - is used as custom text on the “Add new” button. Overrides add_button if both are set.
save_button - is used as text on the “Save” button when the user is filling out data.
save_and_next_button - is used as text on the “Save and open next” button if enabled.
edit_button_open - is used as text on the “Edit” button on the table when the user is opening an element.
edit_button_close - is used as text on the “Edit” button on the table when the user is closing an element.

Groups in the data model contain one or more fields. Groups are defined as repeating if they have maxCount > 1 in the layout configuration. A group that is repeating in the data model must also be set up as repeating in the form, if not, data saving will fail. In JSON, a repeating group is defined as an array of objects, where each object is a group. In XML, a repeating group is defined as a list of elements, where each element is a group/object with properties.