Skip to content

Multifield

wcm/dialogs/components/textfield

Description

The Multifield component allows users to add, reorder or remove multiple instances of a field (or fields).

In a simple case, Multifield can be used with a single field (e.g., TextField, see example below). However, it can also create a complex component that acts as an aggregate of multiple subcomponents (such as address entries in example below) or use nested Multifield (such as address inside of the users is same example).

The field used in Multifield components behaves the same as it does within a plain dialog (e.g., when hiding labels).

Properties

  • name - string (required)
    Form field name

  • label - string
    Display label value

  • required
    Indicates if field value is mandatory

Example

Multifield with TextField:

"users": {
  "sling:resourceType": "wcm/dialogs/components/multifield",
  "name": "users",
  "label": "users",
  "name": {
    "sling:resourceType": "wcm/dialogs/components/textfield",
    "name": "name",
    "label": "name"
  }
}

MultiField

Multifield with nested Multiefield containing 2 fields.

"users": {
  "sling:resourceType": "wcm/dialogs/components/multifield",
  "name": "users",
  "label": "Users",
  "namefield": {
    "sling:resourceType": "wcm/dialogs/components/textfield",
    "name": "name",
    "label": "Name"
  },
  "addresses": {
    "sling:resourceType": "wcm/dialogs/components/multifield",
    "name": "addresses",
    "label": "Addresses",
    "street": {
      "sling:resourceType": "wcm/dialogs/components/textfield",
      "name": "street",
      "label": "Street"
    },
    "city": {
      "sling:resourceType": "wcm/dialogs/components/textfield",
      "name": "city",
      "label": "City"
    }
  }
}