Magnolia 5.4 reached end of life on November 15, 2018. This branch is no longer supported, see End-of-life policy.
Class: info.magnolia.ui.form.field.definition.CompositeFieldDefinition
Here is a composite field that consists of a text field and a date field.
To export the content of the composite fields for translation via the CTS module, the composite
field type has to be registered in the configuration of the module. For details see Registering additional field types.
Simple composite field definition:
form: tabs: - name: tabEvent label: Event fields: - name: title class: info.magnolia.ui.form.field.definition.CompositeFieldDefinition label: Event fields: - name: title class: info.magnolia.ui.form.field.definition.TextFieldDefinition label: Title - name: date class: info.magnolia.ui.form.field.definition.DateFieldDefinition label: Date
Node name | Value |
---|---|
form |
|
tabs |
|
tabEvent |
|
fields |
|
event |
|
fields |
|
title | |
class | info.magnolia.ui.form.field.definition.TextFieldDefinition |
label | Title |
date | |
class | info.magnolia.ui.form.field.definition.DateFieldDefinition |
label | Date |
class | info.magnolia.ui.form.field.definition.CompositeFieldDefinition |
label | Event |
You can use common field properties and the following properties in a composite field definition:
Properties:
<composite field name> | required Name of parent composite field. |
| required Node containing child fields. |
| required Name of the child fields. You can use any simple field definition. |
| required Field definition class of the child field. |
| required/optional Any properties the child field supports. |
| required Definition class of the composite parent field. Use |
| optional, default is Defines the layout of the child fields: |
| optional, default is Custom property transformer definition. |
Best practice
When nesting composite fields, use the delegating transformer classes, DelegatingCompositeFieldTransformer or DelegatingMultiValueFieldTransformer, rather than the other available transformer classes.