ViewHelper Documentation


Tree (select supertype) FlexForm field ViewHelper


name string

Name of the attribute, FlexForm XML-valid tag name string

label string

Label for the attribute, can be LLL: value. Optional - if not specified, Flux tries to detect an LLL label named "flux.fluxFormId.fields.foobar" based on field name, in scope of extension rendering the Flux form. If field is in an object, use "flux.fluxFormId.objects.objectname.foobar" where "foobar" is the name of the field.

default string

Default value for this attribute

required boolean

If TRUE, this attribute must be filled when editing the FCE

exclude boolean

If TRUE, this field becomes an "exclude field" (see TYPO3 documentation about this)

transform string

Set this to transform your value to this type - integer, array (for csv values), float, DateTime, Vendor\MyExt\Domain\Model\Object or ObjectStorage with type hint.

enabled boolean

If FALSE, disables the field in the FlexForm

requestUpdate boolean

If TRUE, the form is force-saved and reloaded when field value changes

displayCond string

Optional "Display Condition" (TCA style) for this particular field. See:

inherit boolean

If TRUE, the value for this particular field is inherited - if inheritance is enabled by the ConfigurationProvider

inheritEmpty boolean

If TRUE, allows empty values (specifically excluding the number zero!) to be inherited - if inheritance is enabled by the ConfigurationProvider

clear boolean

If TRUE, a "clear value" checkbox is displayed next to the field which when checked, completely destroys the current field value all the way down to the stored XML value

variables anySimpleType

Freestyle variables which become assigned to the resulting Component - can then be read from that Component outside this Fluid template and in other templates using the Form object from this template

extensionName string

If provided, enables overriding the extension context for this and all child nodes. The extension name is otherwise automatically detected from rendering context.

validate string

FlexForm-type validation configuration for this input

size integer

Size of the selector box

multiple boolean

If TRUE, allows multiple selections

minItems integer

Minimum required number of items to be selected

maxItems integer

Maxium allowed number of items to be selected

itemListStyle string

Overrides the default list style when maxItems > 1

selectedListStyle string

Overrides the default selected list style when maxItems > 1 and renderMode is default

renderMode string

Alternative rendering mode - default is an HTML select field but you can also use fx "checkbox" - see TCA "select" field "renderType" attribute

items anySimpleType

Items for the selector; array / CSV / Traversable / Query supported

emptyOption anySimpleType

If not-FALSE, adds one empty option/value pair to the generated selector box and tries to use this property's value (cast to string) as label.

translateCsvItems boolean

If TRUE, attempts to resolve a LLL label for each value provided as CSV in "items" attribute using convention for lookup "$field.option.123" if given "123" as CSV item value. Field name is determined by normal Flux field name conventions

table string

Define foreign table name to turn selector into a record selector for that table

condition string

Condition to use when selecting from "foreignTable", supports FlexForm "foregin_table_where" markers

mm string

Optional name of MM table to use for record selection

foreignField string

The foreign_field is the field of the child record pointing to the parent record. This defines where to store the uid of the parent record.

foreignLabel string

If set, it overrides the label set in TCA[foreign_table]['ctrl']['label'] for the inline-view.

foreignSelector string

A selector is used to show all possible child records that could be used to create a relation with the parent record. It will be rendered as a multi-select-box. On clicking on an item inside the selector a new relation is created. The foreign_selector points to a field of the foreign_table that is responsible for providing a selector-box this field on the foreign_table usually has the type "select" and also has a "foreign_table" defined.

foreignSortby string

Field on the child record (or on the intermediate table) that stores the manual sorting information.

foreignDefaultSortby string

If a fieldname for foreign_sortby is defined, then this is ignored. Otherwise this is used as the "ORDER BY" statement to sort the records in the table when listed.

foreignTableField string

The field of the child record pointing to the parent record. This defines where to store the table name of the parent record. On setting this configuration key together with foreign_field, the child record knows what its parent record is - so the child record could also be used on other parent tables.

foreignUnique string

Field which must be uniue for all children of a parent record.

symmetricField string

In case of bidirectional symmetric relations, this defines in which field on the foreign table the uid of the "other" parent is stored.

symmetricLabel string

If set, this overrides the default label of the selected symmetric_field.

symmetricSortby string

Works like foreign_sortby, but defines the field on foreign_table where the "other" sort order is stored.

localizationMode string

Set whether children can be localizable ('select') or just inherit from default language ('keep').

localizeChildrenAtParentLocalization boolean

Defines whether children should be localized when the localization of the parent gets created.

disableMovingChildrenWithParent boolean

Disables that child records get moved along with their parent records.

showThumbs boolean

If TRUE, adds thumbnail display when editing in BE

matchFields anySimpleType

When using manyToMany you can provide an additional array of field=>value pairs that must match in the relation table

oppositeField string

Name of the opposite field related to a proper mm relation

parentField string

Field containing UID of parent record

allowRecursiveMode boolean

If TRUE, the selection of a node will trigger the selection of all child nodes too (recursively)

expandAll boolean

If TRUE, expands all branches

nonSelectableLevels string

Comma-separated list of levels that will not be selectable, by default the root node (which is "0") cannot be selected

maxLevels integer

The maximal amount of levels to be rendered (can be used to stop possible recursions)

showHeader boolean

If TRUE, displays tree header

width integer

Width of TreeView component

ViewHelper Resources

Schema Resources