[BUGFIX] Submitted form data has precedence over value argument
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / master / Deprecation-66588-POSTDataInSelectviewhelperShouldHaveHigherPriorityThanValueValue.rst
1 ==================================================================================================
2 Deprecation: #66588 - POST Data in selectviewhelper should have higher priority than "value" value
3 ==================================================================================================
4
5 Description
6 ===========
7
8 Submitted form data has precedence over value argument
9
10 This adjusts the behavior of all Form ViewHelpers so that any
11 submitted value is redisplayed even if a "value" argument has been
12 specified.
13
14 The issue with this, however, was that upon re-display of the form due
15 to property-mapping or validation errors the value argument had
16 precedence over the previously submitted value.
17
18
19 Impact
20 ======
21
22 This is a breaking change if you expect the previous behavior of form
23 ViewHelpers always being pre-populated with the specified value
24 attribute / bound object property even when re-displaying the form upon
25 validation errors.
26
27 Besides this change deprecates
28 ``AbstractFormFieldViewHelper::getValue()``. If you call that method in
29 your custom ViewHelpers you should use
30 ``AbstractFormFieldViewHelper::getValueAttribute()`` instead and call
31 ``AbstractFormFieldViewHelper::addAdditionalIdentityPropertiesIfNeeded()``
32 explicitly if the ViewHelper might be bound to (sub)entities.
33
34 The default usage of getValueAttribute() not respect the submitted form data, because not every viewhelper need
35 this feature. But you can enable the usage of the form data by setting the
36 AbstractFormFieldViewHelper::respectSubmittedDataValue to TRUE.