Repeating sets of nested form fields.
Provides a form containing repeatable rows of nested fields that you define. Users can add as many entries as needed, with each row replicating the specified field structure. This field type relies on a jQuery-based JavaScript file to handle dynamic behaviour and is ideal for managing structured, multi-value input.
| Property | Example | Adjustable | Mandatory | Description |
|---|---|---|---|---|
| type | subform |  |
|
(mandatory) must be subform. |
| name | options |  |
|
(mandatory) is the unique name of the parameter |
| label | The Option List | |
|
(mandatory) (translatable) is the descriptive title of the field. |
| layout | joomla.form.field.subform.repeatable-table | |
|
(mandatory) The layout for the repeatable table. |
| component | — | |
|
(optional) To change the component where it should search for layout |
| client | — | |
|
(optional) Function to initialise the application clientFrontend: site or 0Backend: admin or 1 |
| multiple | true | |
|
(mandatory) The rows to be multiple. |
| buttons | add,remove,move | |
|
(optional) Which buttons to show if multiple mode is true.Options: add,remove,move |
| fields | guid,guid,guid | |
|
(mandatory) The fields to add to the modal. All fields must first be created in component builder as a field before you can add them here, since you must use the id of the field. Separate the field ids/guids with commas. Do not add custom fields that are not also used in this component. |
| formsource | — | |
|
(optional) you can add a path to a xml file containing the fields. |
| description | — | |
|
(optional) (translatable) description text for the form field. Displays at the top of the modal with the name as well as in the usual position in the form |
| default | — | |
|
(optional) The default value for the form field if the field is left empty. Note this has to be a json string compatible with the contents of the form field. |
| icon | list | |
|
(optional) The icon to show on the select button (is prefixed with "icon-"). |
| max | 50 | |
|
(optional) The maximum number of rows of fields allowed (by default 999 to be effectively infinite) |
| min | — | |
|
(optional) The minimum number of rows of fields required |
| filter | — | |
|
(optional) Use only if you would like to save raw data, since the default is best. |
| showon | — | |
|
(optional) show this field on the bases of the value in another field. https://joomla.stackexchange.com/a/17682/2166 |
Integrate, customize, and update this JCB Fieldtype with ease through JCB's flexible ecosystem.
Used in Joomla Component Builder - Source - Mirror - Download
