FormViewHelper extends AbstractFormViewHelper

Form ViewHelper. Generates a :html:`<form>` Tag. Tailored for extbase plugins, uses extbase Request.

Basic usage

Use :html:<f:form> to output an HTML :html:<form> tag which is targeted at the specified action, in the current controller and package. It will submit the form data via a POST request. If you want to change this, use :html:method="get" as an argument.

Examples

A complex form with a specified encoding type

Form with enctype set::

<f:form action=".." controller="..." package="..." enctype="multipart/form-data">...</f:form>

A Form which should render a domain object

Binding a domain object to a form::

<f:form action="..." name="customer" object="{customer}"> <f:form.hidden property="id" /> <f:form.textarea property="name" /> </f:form>

This automatically inserts the value of {customer.name} inside the textarea and adjusts the name of the textarea accordingly.

Table of Contents

Properties

$configurationManager  : ConfigurationManagerInterface
$extensionService  : ExtensionService
$formActionUriArguments  : array<string|int, mixed>
We need the arguments of the formActionUri on request hash calculation therefore we will store them in here right after calling uriBuilder
$hashService  : HashService
$mvcPropertyMappingConfigurationService  : MvcPropertyMappingConfigurationService
$persistenceManager  : PersistenceManagerInterface
$tagName  : string

Methods

initializeArguments()  : void
injectConfigurationManager()  : void
injectExtensionService()  : void
injectHashService()  : void
injectMvcPropertyMappingConfigurationService()  : void
injectPersistenceManager()  : void
render()  : string
addFieldNamePrefixToViewHelperVariableContainer()  : void
Adds the field name prefix to the ViewHelperVariableContainer.
addFormFieldNamesToViewHelperVariableContainer()  : void
Adds a container for form field names to the ViewHelperVariableContainer.
addFormObjectNameToViewHelperVariableContainer()  : void
Adds the form object name to the ViewHelperVariableContainer if "objectName" argument or "name" attribute is specified.
addFormObjectToViewHelperVariableContainer()  : void
Adds the object that is bound to this form to the ViewHelperVariableContainer if the formObject attribute is specified.
getDefaultFieldNamePrefix()  : string
Retrieves the default field name prefix for this form
getFieldNamePrefix()  : string
getFormObjectName()  : string
Returns the name of the object that is bound to this form.
prefixFieldName()  : string
Prefixes / namespaces the given name with the form field prefix
registerFieldNameForFormTokenGeneration()  : void
Register a field name for inclusion in the HMAC / Form Token generation
removeCheckboxFieldNamesFromViewHelperVariableContainer()  : void
Remove Checkbox field names from ViewHelper variable container, to start from scratch when a new form starts.
removeFieldNamePrefixFromViewHelperVariableContainer()  : void
Removes field name prefix from the ViewHelperVariableContainer.
removeFormFieldNamesFromViewHelperVariableContainer()  : void
Removes the container for form field names from the ViewHelperVariableContainer.
removeFormObjectFromViewHelperVariableContainer()  : void
Removes the form object from the ViewHelperVariableContainer.
removeFormObjectNameFromViewHelperVariableContainer()  : void
Removes the form name from the ViewHelperVariableContainer.
renderAdditionalIdentityFields()  : string
Render additional identity fields which were registered by form elements.
renderHiddenIdentityField()  : string
Renders a hidden form field containing the technical identity of the given object.
renderHiddenReferrerFields()  : string
Renders hidden form fields for referrer information about the current controller and action.
renderRequestTokenHiddenField()  : string
renderTrustedPropertiesField()  : string
Render the request hash field
setFormActionUri()  : void
Sets the "action" attribute of the form tag

Properties

$formActionUriArguments

We need the arguments of the formActionUri on request hash calculation therefore we will store them in here right after calling uriBuilder

protected array<string|int, mixed> $formActionUriArguments = []

$tagName

protected string $tagName = 'form'

Methods

initializeArguments()

public initializeArguments() : void

render()

public render() : string
Return values
string

addFieldNamePrefixToViewHelperVariableContainer()

Adds the field name prefix to the ViewHelperVariableContainer.

protected addFieldNamePrefixToViewHelperVariableContainer() : void

addFormFieldNamesToViewHelperVariableContainer()

Adds a container for form field names to the ViewHelperVariableContainer.

protected addFormFieldNamesToViewHelperVariableContainer() : void

addFormObjectNameToViewHelperVariableContainer()

Adds the form object name to the ViewHelperVariableContainer if "objectName" argument or "name" attribute is specified.

protected addFormObjectNameToViewHelperVariableContainer() : void

addFormObjectToViewHelperVariableContainer()

Adds the object that is bound to this form to the ViewHelperVariableContainer if the formObject attribute is specified.

protected addFormObjectToViewHelperVariableContainer() : void

getDefaultFieldNamePrefix()

Retrieves the default field name prefix for this form

protected getDefaultFieldNamePrefix() : string
Return values
string

getFieldNamePrefix()

protected getFieldNamePrefix() : string
Return values
string

getFormObjectName()

Returns the name of the object that is bound to this form.

protected getFormObjectName() : string

If the "objectName" argument has been specified, this is returned. Otherwise the name attribute of this form. If neither objectName nor name arguments have been set, NULL is returned.

Return values
string

specified Form name or NULL if neither $objectName nor $name arguments have been specified

prefixFieldName()

Prefixes / namespaces the given name with the form field prefix

protected prefixFieldName(string $fieldName) : string
Parameters
$fieldName : string
Return values
string

registerFieldNameForFormTokenGeneration()

Register a field name for inclusion in the HMAC / Form Token generation

protected registerFieldNameForFormTokenGeneration(string $fieldName) : void
Parameters
$fieldName : string

removeCheckboxFieldNamesFromViewHelperVariableContainer()

Remove Checkbox field names from ViewHelper variable container, to start from scratch when a new form starts.

protected removeCheckboxFieldNamesFromViewHelperVariableContainer() : void

removeFieldNamePrefixFromViewHelperVariableContainer()

Removes field name prefix from the ViewHelperVariableContainer.

protected removeFieldNamePrefixFromViewHelperVariableContainer() : void

removeFormFieldNamesFromViewHelperVariableContainer()

Removes the container for form field names from the ViewHelperVariableContainer.

protected removeFormFieldNamesFromViewHelperVariableContainer() : void

removeFormObjectFromViewHelperVariableContainer()

Removes the form object from the ViewHelperVariableContainer.

protected removeFormObjectFromViewHelperVariableContainer() : void

removeFormObjectNameFromViewHelperVariableContainer()

Removes the form name from the ViewHelperVariableContainer.

protected removeFormObjectNameFromViewHelperVariableContainer() : void

renderAdditionalIdentityFields()

Render additional identity fields which were registered by form elements.

protected renderAdditionalIdentityFields() : string

This happens if a form field is defined like property="bla.blubb" - then we might need an identity property for the sub-object "bla".

Return values
string

HTML-string for the additional identity properties

renderHiddenIdentityField()

Renders a hidden form field containing the technical identity of the given object.

protected renderHiddenIdentityField(mixed $object, string|null $name) : string
Parameters
$object : mixed

Object to create the identity field for. Non-objects are ignored.

$name : string|null

Name

Tags
see
Argument::setValue()
Return values
string

A hidden field containing the Identity (uid) of the given object

renderHiddenReferrerFields()

Renders hidden form fields for referrer information about the current controller and action.

protected renderHiddenReferrerFields() : string
Tags
todo

filter out referrer information that is equal to the target (e.g. same packageKey)

Return values
string

Hidden fields with referrer information

renderRequestTokenHiddenField()

protected renderRequestTokenHiddenField() : string
Return values
string

renderTrustedPropertiesField()

Render the request hash field

protected renderTrustedPropertiesField() : string
Return values
string

setFormActionUri()

Sets the "action" attribute of the form tag

protected setFormActionUri() : void

        
On this page

Search results