TYPO3  7.6
Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
AbstractFormFieldViewHelper Class Reference
Inheritance diagram for AbstractFormFieldViewHelper:
AbstractFormViewHelper AbstractTagBasedViewHelper AbstractViewHelper ButtonViewHelper CheckboxViewHelper HiddenViewHelper PasswordViewHelper RadioViewHelper SelectViewHelper SubmitViewHelper TextareaViewHelper TextfieldViewHelper UploadViewHelper

Public Member Functions

 initializeArguments ()
 
 getRespectSubmittedDataValue ()
 
 setRespectSubmittedDataValue ($respectSubmittedDataValue)
 

Protected Member Functions

 getName ()
 
 getRequest ()
 
 getNameWithoutPrefix ()
 
 getValue ($convertObjects=true)
 
 getValueAttribute ()
 
 getValueFromSubmittedFormData ($value)
 
 convertToPlainValue ($value)
 
 hasMappingErrorOccurred ()
 
 getLastSubmittedFormData ()
 
 addAdditionalIdentityPropertiesIfNeeded ()
 
 getPropertyValue ()
 
 isObjectAccessorMode ()
 
 setErrorClassAttribute ()
 
 getMappingResultsForProperty ()
 
 renderHiddenFieldForEmptyValue ()
 
- Protected Member Functions inherited from AbstractFormViewHelper
 prefixFieldName ($fieldName)
 
 renderHiddenIdentityField ($object, $name)
 
 registerFieldNameForFormTokenGeneration ($fieldName)
 
- Protected Member Functions inherited from AbstractTagBasedViewHelper
 registerTagAttribute ($name, $type, $description, $required=false, $default=null)
 
 registerUniversalTagAttributes ()
 
- Protected Member Functions inherited from AbstractViewHelper
 registerArgument ($name, $type, $description, $required=false, $defaultValue=null)
 
 overrideArgument ($name, $type, $description, $required=false, $defaultValue=null)
 
 callRenderMethod ()
 
 getLogger ()
 
 buildRenderChildrenClosure ()
 
 hasArgument ($argumentName)
 

Protected Attributes

 $configurationManager
 
 $respectSubmittedDataValue = false
 
- Protected Attributes inherited from AbstractFormViewHelper
 $persistenceManager
 
- Protected Attributes inherited from AbstractTagBasedViewHelper
 $tag = null
 
 $tagName = 'div'
 
- Protected Attributes inherited from AbstractViewHelper
 $arguments
 
 $templateVariableContainer
 
 $controllerContext
 
 $renderingContext
 
 $renderChildrenClosure = null
 
 $viewHelperVariableContainer
 
 $objectManager
 
 $escapingInterceptorEnabled = true
 

Additional Inherited Members

- Static Public Member Functions inherited from AbstractViewHelper
static renderStatic (array $arguments,\Closure $renderChildrenClosure,\TYPO3\CMS\Fluid\Core\Rendering\RenderingContextInterface $renderingContext)
 

Detailed Description

Abstract Form View Helper. Bundles functionality related to direct property access of objects in other Form ViewHelpers.

If you set the "property" attribute to the name of the property to resolve from the object, this class will automatically set the name and value of a form element.

Definition at line 36 of file AbstractFormFieldViewHelper.php.

Member Function Documentation

addAdditionalIdentityPropertiesIfNeeded ( )
protected

Add additional identity properties in case the current property is hierarchical (of the form "bla.blubb"). Then, [bla][__identity] has to be generated as well.

Returns
void

Definition at line 278 of file AbstractFormFieldViewHelper.php.

References ObjectAccess\getPropertyPath(), AbstractFormFieldViewHelper\isObjectAccessorMode(), and AbstractFormViewHelper\renderHiddenIdentityField().

Referenced by AbstractFormFieldViewHelper\getValue(), TextareaViewHelper\render(), TextfieldViewHelper\render(), PasswordViewHelper\render(), and SelectViewHelper\render().

convertToPlainValue (   $value)
protected

Converts an arbitrary value to a plain value

Parameters
mixed$valueThe value to convert
Returns
mixed

Definition at line 236 of file AbstractFormFieldViewHelper.php.

Referenced by AbstractFormFieldViewHelper\getValue(), AbstractFormFieldViewHelper\getValueAttribute(), and RadioViewHelper\render().

getLastSubmittedFormData ( )
protected

Get the form data which has last been submitted; only returns valid data in case a property mapping error has occurred. Check with hasMappingErrorOccurred() before!

Returns
mixed

Definition at line 263 of file AbstractFormFieldViewHelper.php.

References AbstractFormFieldViewHelper\getNameWithoutPrefix(), and ObjectAccess\getPropertyPath().

Referenced by AbstractFormFieldViewHelper\getValue(), AbstractFormFieldViewHelper\getValueFromSubmittedFormData(), CheckboxViewHelper\render(), and RadioViewHelper\render().

getMappingResultsForProperty ( )
protected

Get errors for the property and form name of this view helper

Returns
Array of errors

Definition at line 382 of file AbstractFormFieldViewHelper.php.

References AbstractFormFieldViewHelper\getRequest(), and AbstractFormFieldViewHelper\isObjectAccessorMode().

Referenced by AbstractFormFieldViewHelper\setErrorClassAttribute().

getName ( )
protected

Get the name of this form element. Either returns arguments['name'], or the correct name for Object Access.

In case property is something like bla.blubb (hierarchical), then [bla][blubb] is generated.

Returns
string Name

Definition at line 95 of file AbstractFormFieldViewHelper.php.

References AbstractFormFieldViewHelper\getNameWithoutPrefix(), and AbstractFormViewHelper\prefixFieldName().

Referenced by HiddenViewHelper\render(), TextareaViewHelper\render(), TextfieldViewHelper\render(), SubmitViewHelper\render(), PasswordViewHelper\render(), UploadViewHelper\render(), CheckboxViewHelper\render(), RadioViewHelper\render(), ButtonViewHelper\render(), SelectViewHelper\render(), and AbstractFormFieldViewHelper\renderHiddenFieldForEmptyValue().

getNameWithoutPrefix ( )
protected

Get the name of this form element, without prefix.

Returns
string name

Definition at line 116 of file AbstractFormFieldViewHelper.php.

References AbstractViewHelper\hasArgument(), and AbstractFormFieldViewHelper\isObjectAccessorMode().

Referenced by AbstractFormFieldViewHelper\getLastSubmittedFormData(), and AbstractFormFieldViewHelper\getName().

getPropertyValue ( )
protected
getRequest ( )
protected

Shortcut for retrieving the request from the controller context

Returns

Definition at line 106 of file AbstractFormFieldViewHelper.php.

Referenced by AbstractFormFieldViewHelper\getMappingResultsForProperty(), and AbstractFormFieldViewHelper\hasMappingErrorOccurred().

getRespectSubmittedDataValue ( )

Getting the current configuration for respectSubmittedDataValue.

Returns
bool

Definition at line 71 of file AbstractFormFieldViewHelper.php.

References AbstractFormFieldViewHelper\$respectSubmittedDataValue.

getValue (   $convertObjects = true)
protected

Get the value of this form element. Either returns arguments['value'], or the correct value for Object Access.

Deprecated:
since TYPO3 CMS 7, will be removed in TYPO3 CMS 8
Parameters
bool$convertObjectswhether or not to convert objects to identifiers
Returns
mixed Value

Definition at line 152 of file AbstractFormFieldViewHelper.php.

References AbstractFormFieldViewHelper\addAdditionalIdentityPropertiesIfNeeded(), AbstractFormFieldViewHelper\convertToPlainValue(), elseif, AbstractFormFieldViewHelper\getLastSubmittedFormData(), AbstractFormFieldViewHelper\getPropertyValue(), AbstractViewHelper\hasArgument(), AbstractFormFieldViewHelper\hasMappingErrorOccurred(), AbstractFormFieldViewHelper\isObjectAccessorMode(), and GeneralUtility\logDeprecatedFunction().

getValueAttribute ( )
protected

Returns the current value of this Form ViewHelper and converts it to an identifier string in case it's an object The value is determined as follows:

  • If property mapping errors occurred and the form is re-displayed, the last submitted value is returned
  • Else the bound property is returned (only in objectAccessor-mode)
  • As fallback the "value" argument of this ViewHelper is used

Note: This method should not be used for form elements that must not change the value attribute, e.g. (radio) buttons and checkboxes.

Returns
mixed Value

Definition at line 185 of file AbstractFormFieldViewHelper.php.

References AbstractFormFieldViewHelper\convertToPlainValue(), elseif, AbstractFormFieldViewHelper\getPropertyValue(), AbstractFormFieldViewHelper\getValueFromSubmittedFormData(), AbstractViewHelper\hasArgument(), and AbstractFormFieldViewHelper\isObjectAccessorMode().

Referenced by SelectViewHelper\getSelectedValue(), HiddenViewHelper\render(), TextareaViewHelper\render(), TextfieldViewHelper\render(), SubmitViewHelper\render(), PasswordViewHelper\render(), RadioViewHelper\render(), CheckboxViewHelper\render(), and ButtonViewHelper\render().

getValueFromSubmittedFormData (   $value)
protected

If property mapping errors occurred and the form is re-displayed, the last submitted value is returned by this method.

Note: This method should not be used for form elements that must not change the value attribute, e.g. (radio) buttons and checkboxes. The default behaviour is not to use this method. You need to set respectSubmittedDataValue to TRUE to enable the form data handling for the viewhelper.

Parameters
mixed$value
Returns
mixed Value

Definition at line 213 of file AbstractFormFieldViewHelper.php.

References elseif, AbstractFormFieldViewHelper\getLastSubmittedFormData(), AbstractFormFieldViewHelper\getPropertyValue(), AbstractViewHelper\hasArgument(), AbstractFormFieldViewHelper\hasMappingErrorOccurred(), and AbstractFormFieldViewHelper\isObjectAccessorMode().

Referenced by AbstractFormFieldViewHelper\getValueAttribute().

hasMappingErrorOccurred ( )
protected

Checks if a property mapping error has occurred in the last request.

Returns
bool TRUE if a mapping error occurred, FALSE otherwise

Definition at line 252 of file AbstractFormFieldViewHelper.php.

References AbstractFormFieldViewHelper\getRequest().

Referenced by AbstractFormFieldViewHelper\getValue(), AbstractFormFieldViewHelper\getValueFromSubmittedFormData(), CheckboxViewHelper\render(), and RadioViewHelper\render().

initializeArguments ( )

Initialize arguments.

Returns
void

Definition at line 55 of file AbstractFormFieldViewHelper.php.

References AbstractViewHelper\registerArgument().

isObjectAccessorMode ( )
protected

Internal method which checks if we should evaluate a domain object or just output arguments['name'] and arguments['value']

Returns
bool TRUE if we should evaluate the domain object, FALSE otherwise.

Definition at line 346 of file AbstractFormFieldViewHelper.php.

References AbstractViewHelper\hasArgument().

Referenced by AbstractFormFieldViewHelper\addAdditionalIdentityPropertiesIfNeeded(), AbstractFormFieldViewHelper\getMappingResultsForProperty(), AbstractFormFieldViewHelper\getNameWithoutPrefix(), AbstractFormFieldViewHelper\getValue(), AbstractFormFieldViewHelper\getValueAttribute(), and AbstractFormFieldViewHelper\getValueFromSubmittedFormData().

renderHiddenFieldForEmptyValue ( )
protected

Renders a hidden field with the same name as the element, to make sure the empty value is submitted in case nothing is selected. This is needed for checkbox and multiple select fields

Returns
string the hidden field.

Definition at line 400 of file AbstractFormFieldViewHelper.php.

References AbstractFormFieldViewHelper\getName().

Referenced by CheckboxViewHelper\render(), and SelectViewHelper\render().

setErrorClassAttribute ( )
protected
setRespectSubmittedDataValue (   $respectSubmittedDataValue)

Define respectSubmittedDataValue to enable or disable the usage of the submitted values in the viewhelper.

Parameters
bool$respectSubmittedDataValue
Returns
void

Definition at line 82 of file AbstractFormFieldViewHelper.php.

References AbstractFormFieldViewHelper\$respectSubmittedDataValue.

Referenced by SelectViewHelper\getSelectedValue(), HiddenViewHelper\render(), TextareaViewHelper\render(), TextfieldViewHelper\render(), and PasswordViewHelper\render().

Member Data Documentation

$configurationManager
protected

Definition at line 42 of file AbstractFormFieldViewHelper.php.

$respectSubmittedDataValue = false
protected