Page tree
Skip to end of metadata
Go to start of metadata

ConfiguredSwitchableFieldDefinition renders a complex field that displays alternative forms depending on user choice. Use the field to switch, for example, between:

  • Plain text and rich text editors.

  • Unauthenticated and authenticated SMTP settings.
  • Same and different addresses for shipping and billing.

This switchable field definition is part of the Magnolia 6 UI framework. The fully qualified class name is info.magnolia.ui.field.ConfiguredSwitchableFieldDefinition.

If you work with the Magnolia 5 UI framework, see Switchable field for Magnolia 5 UI instead.

Example definition

switchable:
  $type: switchableField
  field:
	$type: radioButtonGroupField
    layout: horizontal
	datasource:
	  $type: optionListDatasource
	  options:
		- name: foo
		  value: foo
		- name: bar
		  value: bar
  itemProvider:
	$type: jcrChildNodeProvider
  forms:
	- name: foo
	  properties:
		foo:
		  $type: textField
	- name: bar
	  properties:
		bar:
		  $type: richTextField

Field properties

Field-specific properties

field

required

Node containing a select field and data source to switch between forms.

As $type, only comboBoxField and radioButtonGroupField are supported.

As datasource, only optionListDatasource can be used.

(info) Options in radioButtonGroupField are positioned vertically by default. A horizontal layout can be configured using the common layout property of option group field.

forms

required

List of forms to switch between. Forms define fields and similar components as well as their layout.

See Form definition for more information.

Common complex field properties

name

required

Name of the field definition item. Derived from the configured node name. Use alphanumeric characters without spaces.

class

required (unless $type is used)

Type of the field definition item. The value must be a fully qualified class name and a subtype of info.magnolia.ui.field.FieldDefinition. See Field types for possible values.

$type

You can use this as a shortcut for class if the definition class is annotated with info.magnolia.ui.field.FieldType. The proper value is defined by the annotation.

Example class annotation
@FieldType("textField")
public class TextFieldDefinition extends ConfiguredFieldDefinition<String> {
...
}

See Field types for possible values.

itemProvider

required, default is

  • JcrPropertyProvider for JcrMultiValueFieldDefinition
  • JcrChildNodeProviderDefinition for JcrMultiFieldDefinition

Node with a $type property that specifies the type of data binding for the subnodes in complex fields.

See Item providers for more information.

description

optional

Help text displayed when the user clicks the help icon. The value can be literal or a key of a message bundle.

i18n

optionaldefault is false

Enables i18n authoring support, which allows editors to write foreign-language or regionally targeted content. A two-letter language identifier (en, de, fr, etc.) is displayed on controls where i18n is set to true.

label

optional

Field label displayed to editors. The value can be literal or a key of a message bundle.

If you do not provide the property, Magnolia will fall back to a generated i18n key.

If you do not want to have any label, set the property to an empty string such as label: "" in YAML.

styleName

optional

Additional style information for an editor property definition item applied to the element when the form is rendered.

The value can be a CSS class or a list of CSS classes separated by white spaces.