[SingleSelect]

Properties

implementationClassName

Option path
TYPO3.CMS.Form.prototypes.<prototypeIdentifier>.formElementsDefinition.SingleSelect.implementationClassName
Data type
string
Needed by
Frontend/ Backend (form editor)
Overwritable within form definition
No
form editor can write this property into the form definition (for prototype ‘standard’)
No
Mandatory
Yes
Default value (for prototype ‘standard’)
1
2
SingleSelect:
  implementationClassName: TYPO3\CMS\Form\Domain\Model\FormElements\GenericFormElement
Description
Classname which implements the form element.

properties.containerClassAttribute

Option path
TYPO3.CMS.Form.prototypes.<prototypeIdentifier>.formElementsDefinition.SingleSelect.properties.containerClassAttribute
Data type
string
Needed by
Frontend/ Backend (form editor)
Overwritable within form definition
Yes
form editor can write this property into the form definition (for prototype ‘standard’)
No
Mandatory
No
Default value (for prototype ‘standard’)
1
2
3
4
5
SingleSelect:
  properties:
    containerClassAttribute: input
    elementClassAttribute: ''
    elementErrorClassAttribute: error
Description
A CSS class which is typically wrapped around the form elements.

properties.elementClassAttribute

Option path
TYPO3.CMS.Form.prototypes.<prototypeIdentifier>.formElementsDefinition.SingleSelect.properties.elementClassAttribute
Data type
string
Needed by
Frontend/ Backend (form editor)
Overwritable within form definition
Yes
form editor can write this property into the form definition (for prototype ‘standard’)
No
Mandatory
No
Default value (for prototype ‘standard’)
1
2
3
4
5
SingleSelect:
  properties:
    containerClassAttribute: input
    elementClassAttribute: ''
    elementErrorClassAttribute: error
Description
A CSS class written to the form element.

properties.elementErrorClassAttribute

Option path
TYPO3.CMS.Form.prototypes.<prototypeIdentifier>.formElementsDefinition.SingleSelect.properties.elementErrorClassAttribute
Data type
string
Needed by
Frontend/ Backend (form editor)
Overwritable within form definition
Yes
form editor can write this property into the form definition (for prototype ‘standard’)
No
Mandatory
No
Default value (for prototype ‘standard’)
1
2
3
4
5
SingleSelect:
  properties:
    containerClassAttribute: input
    elementClassAttribute: ''
    elementErrorClassAttribute: error
Description
A CSS class which is written to the form element if validation errors exists.

properties.prependOptionLabel

Option path
TYPO3.CMS.Form.prototypes.<prototypeIdentifier>.formElementsDefinition.SingleSelect.properties.prependOptionLabel
Data type
string
Needed by
Frontend/ Backend (form editor)
Overwritable within form definition
Yes
form editor can write this property into the form definition (for prototype ‘standard’)
Yes
Mandatory
No
Default value (for prototype ‘standard’)
undefined
Description
If set, this label will be shown as first select-option.

properties.prependOptionValue

Option path
TYPO3.CMS.Form.prototypes.<prototypeIdentifier>.formElementsDefinition.SingleSelect.properties.prependOptionValue
Data type
string
Needed by
Frontend/ Backend (form editor)
Overwritable within form definition
Yes
form editor can write this property into the form definition (for prototype ‘standard’)
No
Mandatory
No
Default value (for prototype ‘standard’)
undefined
Description
If set, this value will be set for the first select-option.

formEditor

Option path
TYPO3.CMS.Form.prototypes.<prototypeIdentifier>.formElementsDefinition.SingleSelect.formEditor
Data type
array
Needed by
Backend (form editor)
Mandatory
Recommended
Default value (for prototype ‘standard’)
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
SingleSelect:
  formEditor:
    editors:
      100:
        identifier: header
        templateName: Inspector-FormElementHeaderEditor
      200:
        identifier: label
        templateName: Inspector-TextEditor
        label: formEditor.elements.FormElement.editor.label.label
        propertyPath: label
      250:
        identifier: inactiveOption
        templateName: Inspector-TextEditor
        label: formEditor.elements.SelectionMixin.editor.inactiveOption.label
        propertyPath: properties.prependOptionLabel
        fieldExplanationText: formEditor.elements.SelectionMixin.editor.inactiveOption.fieldExplanationText
        doNotSetIfPropertyValueIsEmpty: true
      300:
        identifier: options
        templateName: Inspector-PropertyGridEditor
        label: formEditor.elements.SelectionMixin.editor.options.label
        propertyPath: properties.options
        isSortable: true
        enableAddRow: true
        enableDeleteRow: true
        removeLastAvailableRowFlashMessageTitle: formEditor.elements.SelectionMixin.editor.options.removeLastAvailableRowFlashMessageTitle
        removeLastAvailableRowFlashMessageMessage: formEditor.elements.SelectionMixin.editor.options.removeLastAvailableRowFlashMessageMessage
        shouldShowPreselectedValueColumn: single
        multiSelection: false
      700:
        identifier: gridColumnViewPortConfiguration
        templateName: Inspector-GridColumnViewPortConfigurationEditor
        label: formEditor.elements.FormElement.editor.gridColumnViewPortConfiguration.label
        configurationOptions:
          viewPorts:
            10:
              viewPortIdentifier: xs
              label: formEditor.elements.FormElement.editor.gridColumnViewPortConfiguration.xs.label
            20:
              viewPortIdentifier: sm
              label: formEditor.elements.FormElement.editor.gridColumnViewPortConfiguration.sm.label
            30:
              viewPortIdentifier: md
              label: formEditor.elements.FormElement.editor.gridColumnViewPortConfiguration.md.label
            40:
              viewPortIdentifier: lg
              label: formEditor.elements.FormElement.editor.gridColumnViewPortConfiguration.lg.label
          numbersOfColumnsToUse:
            label: formEditor.elements.FormElement.editor.gridColumnViewPortConfiguration.numbersOfColumnsToUse.label
            propertyPath: 'properties.gridColumnClassAutoConfiguration.viewPorts.{@viewPortIdentifier}.numbersOfColumnsToUse'
            fieldExplanationText: formEditor.elements.FormElement.editor.gridColumnViewPortConfiguration.numbersOfColumnsToUse.fieldExplanationText
      800:
        identifier: requiredValidator
        templateName: Inspector-RequiredValidatorEditor
        label: formEditor.elements.FormElement.editor.requiredValidator.label
        validatorIdentifier: NotEmpty
        propertyPath: properties.fluidAdditionalAttributes.required
        propertyValue: required
      9999:
        identifier: removeButton
        templateName: Inspector-RemoveElementEditor
    predefinedDefaults:
      properties:
        options: {  }
    label: formEditor.elements.SingleSelect.label
    group: select
    groupSorting: 200
    iconIdentifier: t3-form-icon-single-select

formEditor.editors.100

Option path
TYPO3.CMS.Form.prototypes.<prototypeIdentifier>.formElementsDefinition.SingleSelect.formEditor.editors.100
Data type
array/ [FormElementHeaderEditor]
Needed by
Backend (form editor)
Mandatory
Recommended
Default value (for prototype ‘standard’)
1
2
3
4
5
6
SingleSelect:
  formEditor:
    editors:
      100:
        identifier: header
        templateName: Inspector-FormElementHeaderEditor

formEditor.editors.200

Option path
TYPO3.CMS.Form.prototypes.<prototypeIdentifier>.formElementsDefinition.SingleSelect.formEditor.editors.200
Data type
array/ [TextEditor]
Needed by
Backend (form editor)
Mandatory
Recommended
Default value (for prototype ‘standard’)
1
2
3
4
5
6
7
8
SingleSelect:
  formEditor:
    editors:
      200:
        identifier: label
        templateName: Inspector-TextEditor
        label: formEditor.elements.FormElement.editor.label.label
        propertyPath: label

formEditor.editors.250

Option path
TYPO3.CMS.Form.prototypes.<prototypeIdentifier>.formElementsDefinition.SingleSelect.formEditor.editors.250
Data type
array/ [TextEditor]
Needed by
Backend (form editor)
Mandatory
Recommended
Default value (for prototype ‘standard’)
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
SingleSelect:
  formEditor:
    editors:
      250:
        identifier: inactiveOption
        templateName: Inspector-TextEditor
        label: formEditor.elements.SelectionMixin.editor.inactiveOption.label
        propertyPath: properties.prependOptionLabel
        fieldExplanationText: formEditor.elements.SelectionMixin.editor.inactiveOption.fieldExplanationText
        doNotSetIfPropertyValueIsEmpty: true

formEditor.editors.300

Option path
TYPO3.CMS.Form.prototypes.<prototypeIdentifier>.formElementsDefinition.SingleSelect.formEditor.editors.300
Data type
array/ [PropertyGridEditor]
Needed by
Backend (form editor)
Mandatory
Recommended
Default value (for prototype ‘standard’)
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
SingleSelect:
  formEditor:
    editors:
      300:
        identifier: options
        templateName: Inspector-PropertyGridEditor
        label: formEditor.elements.SelectionMixin.editor.options.label
        propertyPath: properties.options
        isSortable: true
        enableAddRow: true
        enableDeleteRow: true
        removeLastAvailableRowFlashMessageTitle: formEditor.elements.SelectionMixin.editor.options.removeLastAvailableRowFlashMessageTitle
        removeLastAvailableRowFlashMessageMessage: formEditor.elements.SelectionMixin.editor.options.removeLastAvailableRowFlashMessageMessage
        shouldShowPreselectedValueColumn: single
        multiSelection: false

formEditor.editors.700

Option path
TYPO3.CMS.Form.prototypes.<prototypeIdentifier>.formElementsDefinition.SingleSelect.formEditor.editors.700
Data type
array/ [GridColumnViewPortConfigurationEditor]
Needed by
Backend (form editor)
Mandatory
Recommended
Default value (for prototype ‘standard’)
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
SingleSelect:
  formEditor:
    editors:
      700:
        identifier: gridColumnViewPortConfiguration
        templateName: Inspector-GridColumnViewPortConfigurationEditor
        label: formEditor.elements.FormElement.editor.gridColumnViewPortConfiguration.label
        configurationOptions:
          viewPorts:
            10:
              viewPortIdentifier: xs
              label: formEditor.elements.FormElement.editor.gridColumnViewPortConfiguration.xs.label
            20:
              viewPortIdentifier: sm
              label: formEditor.elements.FormElement.editor.gridColumnViewPortConfiguration.sm.label
            30:
              viewPortIdentifier: md
              label: formEditor.elements.FormElement.editor.gridColumnViewPortConfiguration.md.label
            40:
              viewPortIdentifier: lg
              label: formEditor.elements.FormElement.editor.gridColumnViewPortConfiguration.lg.label
          numbersOfColumnsToUse:
            label: formEditor.elements.FormElement.editor.gridColumnViewPortConfiguration.numbersOfColumnsToUse.label
            propertyPath: 'properties.gridColumnClassAutoConfiguration.viewPorts.{@viewPortIdentifier}.numbersOfColumnsToUse'
            fieldExplanationText: formEditor.elements.FormElement.editor.gridColumnViewPortConfiguration.numbersOfColumnsToUse.fieldExplanationText

formEditor.editors.800

Option path
TYPO3.CMS.Form.prototypes.<prototypeIdentifier>.formElementsDefinition.SingleSelect.formEditor.editors.800
Data type
array/ [RequiredValidatorEditor]
Needed by
Backend (form editor)
Mandatory
Recommended
Default value (for prototype ‘standard’)
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
SingleSelect:
  formEditor:
    editors:
      800:
        identifier: requiredValidator
        templateName: Inspector-RequiredValidatorEditor
        label: formEditor.elements.FormElement.editor.requiredValidator.label
        validatorIdentifier: NotEmpty
        propertyPath: properties.fluidAdditionalAttributes.required
        propertyValue: required

formEditor.editors.9999

Option path
TYPO3.CMS.Form.prototypes.<prototypeIdentifier>.formElementsDefinition.SingleSelect.formEditor.editors.9999
Data type
array/ [RemoveElementEditor]
Needed by
Backend (form editor)
Mandatory
Recommended
Default value (for prototype ‘standard’)
1
2
3
4
5
6
SingleSelect:
  formEditor:
    editors:
      9999:
        identifier: removeButton
        templateName: Inspector-RemoveElementEditor

formEditor.predefinedDefaults

Option path
TYPO3.CMS.Form.prototypes.<prototypeIdentifier>.formElementsDefinition.SingleSelect.formEditor.predefinedDefaults
Data type
array
Needed by
Backend (form editor)
Mandatory
Recommended
Default value (for prototype ‘standard’)
1
2
3
4
5
SingleSelect:
  formEditor:
    predefinedDefaults:
      properties:
        options: {  }
Description
Defines predefined defaults for form element properties which are prefilled, if the form element is added to a form.

formEditor.label

Option path
TYPO3.CMS.Form.prototypes.<prototypeIdentifier>.formElementsDefinition.SingleSelect.formEditor.label
Data type
string
Needed by
Backend (form editor)
Mandatory
Yes
Default value (for prototype ‘standard’)
1
2
3
SingleSelect:
  formEditor:
    label: formEditor.elements.SingleSelect.label
Good to know
Description
This label will be shown within the “new element” Modal.

formEditor.group

Option path
TYPO3.CMS.Form.prototypes.<prototypeIdentifier>.formElementsDefinition.SingleSelect.formEditor.group
Data type
string
Needed by
Backend (form editor)
Mandatory
Recommended
Default value (for prototype ‘standard’)
1
2
3
SingleSelect:
  formEditor:
    group: select
Default value
Depends (see concrete element configuration)
Description
Define within which group within the form editor “new Element” modal the form element should be shown. The group value must be equal to an array key within formElementGroups.

formEditor.groupSorting

Option path
TYPO3.CMS.Form.prototypes.<prototypeIdentifier>.formElementsDefinition.SingleSelect.formEditor.groupSorting
Data type
int
Needed by
Backend (form editor)
Mandatory
Recommended
Default value (for prototype ‘standard’)
1
2
3
SingleSelect:
  formEditor:
    groupSorting: 200
Description
The position within the formEditor.group for this form element.

formEditor.iconIdentifier

Option path
TYPO3.CMS.Form.prototypes.<prototypeIdentifier>.formElementsDefinition.SingleSelect.formEditor.iconIdentifier
Data type
string
Needed by
Backend (form editor)
Mandatory
Yes
Default value (for prototype ‘standard’)
1
2
3
SingleSelect:
  formEditor:
    iconIdentifier: t3-form-icon-single-select
Description

An icon identifier which must be registered through the \TYPO3\CMS\Core\Imaging\IconRegistry. This icon will be shown within