View models
Renderables are converted to so-called view models, which is done by dedicated view model builders. Each view model represents the default view implementation of a renderable, based on the Fluid templates shipped by EXT:form. Note that some renderables might be represented by various view model implementations, based on specific aspects outlined below.
Tip
You can also create custom view model builders by implementing the
\CPSIT\ interface.
Where a renderable can resolve to more than one view model, each possible outcome is listed as its own sub-section below, named after the condition under which it applies.
See also
Choosing a view model type explains what each view model type below is for and when to use it in a custom builder.
The following renderables are currently supported by this extension. The table below gives a quick overview; each renderable is covered in detail further down, including the exact conditions for each outcome.
Overview
| Renderable | View model |
|---|---|
Advanced |
View |
Checkbox
|
View |
Content |
View (valid UID) or
Simple
(invalid UID) |
Country |
View |
Fieldset
|
Standalone |
File,
Image |
View (resolved) or
View
(unresolved) |
Form
|
View |
Hidden
|
View |
Multi |
Form or
View (per option) |
Password
|
View |
Radio |
Form or
View (per option) |
Single,
Multi |
View |
Static |
Form (label available) or
Standalone
(no label) |
Textarea
|
View |
Text
,
Date
,
Email
,
Number
,
Telephone
,
Url
|
View |
Date | not supported |
Supported renderables
AdvancedPassword
Represented by
View, containing two child view models:
passwordField View— result fromHelper Contained View Model <formvh:view helper invocation for the password field.form. password> confirmationField FormorField View Model View— result fromHelper Contained View Model <formvh:view helper invocation for the confirmation field, combined with the confirmation label when available; otherwise returned standalone.form. password>
Checkbox
Represented by
View, containing the result from
<formvh: view helper invocation.
ContentElement
Represented by
View, containing the result from
<f: view helper invocation.
Represented by
Simple as fallback, used when the configured UID cannot
be resolved.
CountrySelect
Represented by
View, containing the result from
<formvh: view helper invocation.
Fieldset
Represented by
Standalone, containing the <fieldset> tag with class
name(s) and additional attributes.
FileUpload
,
ImageUpload
Represented by
View, containing three child view models:
uploadField View— result fromHelper Contained View Model <formvh:view helper invocation for the upload field.form. uploaded Resource> resourcePointer Fields ViewofModel Collection Standalone— optional; references hiddenTag View Model <input>fields with resource pointers, if available.uploadsViewofModel Collection File— references file uploads. Each contains aResource View Model resource(FileorReference Pseudo) and, optionally (TYPO3 >= v14), aFile Reference delete(Checkbox Form) to delete the upload on submit.Field View Model
Represented by
View, containing the result from
<formvh: view helper invocation.
Form
Represented by
View, containing the result from
<formvh: view helper invocation.
MultiCheckbox
Contains one view model per available option, each as one of:
Represented by
Form, combining the label and result from
<formvh: view helper invocation.
Represented by
View, containing the result from
<formvh: view helper invocation.
Password
Represented by
View, containing the result from
<formvh: view helper invocation.
RadioButton
Contains one view model per available option, each as one of:
Represented by
Form, combining the label and result from
<formvh: view helper invocation.
Represented by
View, containing the result from
<formvh: view helper invocation.
SingleSelect
,
MultiSelect
Represented by
View, containing the result from
<formvh: view helper invocation. Includes available <option> tags as children
of type
Standalone.
StaticText
Represented by
Form, combining the label and a <p> tag.
Represented by
Standalone, containing a <p> tag with class and text.
Textarea
Represented by
View, containing the result from
<formvh: view helper invocation.
Text and other text-based fields
Applies to
Text
,
Date
,
Email
,
Number
,
Telephone
, and
Url
.
Represented by
View, containing the result from
<formvh: view helper invocation.
Unsupported renderables
DatePicker
This form element was deprecated in TYPO3 v14.2 and is therefore not supported by this extension.