[TASK] Enable mssql on PHP 7.3 nightly tests
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / 8.0 / Breaking-69863-ChangesInViewHelpersPostFluidStandalone.rst
1
2 .. include:: ../../Includes.txt
3
4 ===============================================================
5 Breaking: #69863 - Changes in ViewHelpers post Standalone-Fluid
6 ===============================================================
7
8 See :issue:`69863`
9
10 Description
11 ===========
12
13 The following ViewHelpers have changed behaviours in Fluid:
14
15 * The `f:case` ViewHelper argument `default` has been marked as deprecated. To indicate which case is the default, use `f:defaultCase`.
16 * Tag content of `f:render` is no longer ignored and will be output if called with `optional="1"`.
17 * Arguments `iconOnly` and `styleAttributes` have been removed from `f:be.buttons.csh`.
18 * Argument `alternateBackgroundColors` has been removed from `f:be.tableList`.
19 * ViewHelpers no longer use the `escapingInterceptorEnabled` property but instead use `escapeChildren` and `escapeOutput` to control each behavior.
20 * All ViewHelpers no longer initialize standard arguments ("additionalArguments" and "data") in `__construct()`, but instead do this in `initializeArguments()`. If you override this method, you need to make sure you include a call to `parent::initializeArguments()` in your subclass.
21
22 The following ViewHelper classes are now only found in namespace `TYPO3Fluid\Fluid\ViewHelpers` and no longer exist in `TYPO3\CMS\Fluid\ViewHelpers`:
23
24 * `TYPO3\CMS\Fluid\ViewHelpers\AliasViewHelper`
25 * `TYPO3\CMS\Fluid\ViewHelpers\SwitchViewHelper`
26 * `TYPO3\CMS\Fluid\ViewHelpers\CaseViewHelper` (present as deprecated alias until final removal)
27 * `TYPO3\CMS\Fluid\ViewHelpers\CommentViewHelper`
28 * `TYPO3\CMS\Fluid\ViewHelpers\CycleViewHelper`
29 * `TYPO3\CMS\Fluid\ViewHelpers\ForViewHelper`
30 * `TYPO3\CMS\Fluid\ViewHelpers\GroupedForViewHelper`
31 * `TYPO3\CMS\Fluid\ViewHelpers\IfViewHelper`
32 * `TYPO3\CMS\Fluid\ViewHelpers\ThenViewHelper`
33 * `TYPO3\CMS\Fluid\ViewHelpers\ElseViewHelper`
34 * `TYPO3\CMS\Fluid\ViewHelpers\LayoutViewHelper`
35 * `TYPO3\CMS\Fluid\ViewHelpers\RenderViewHelper`
36 * `TYPO3\CMS\Fluid\ViewHelpers\SectionViewHelper`
37 * `TYPO3\CMS\Fluid\ViewHelpers\SpacelessViewHelper`
38 * `TYPO3\CMS\Fluid\ViewHelpers\Format\CdataViewHelper`
39 * `TYPO3\CMS\Fluid\ViewHelpers\Format\HtmlspecialcharsViewHelper`
40 * `TYPO3\CMS\Fluid\ViewHelpers\Format\PrintfViewHelper`
41 * `TYPO3\CMS\Fluid\ViewHelpers\Format\RawViewHelper`
42
43 Impact
44 ======
45
46 * A warning about use of an unregistered argument `default` will be displayed if templates contain `f:case` with `default` argument.
47 * Unexpected template output will be output if templates are rendered which contain `<f:render partial/section optional="1">will be output now</f:render>`.
48 * A warning about use of an unregistered argument `iconOnly` and/or `styleAttributes` will be displayed if templates contain `f:be.buttons.csh` with either argument.
49 * A warning about use of an unregistered argument `alternateBackgroundColors` will be displayed if templates contain `f:be.tableList` with that argument.
50 * Any third-party ViewHelpers subclassing any of the classes listed above must change parent class to new namespace.
51 * Any third-party ViewHelpers using `escapingInterceptorEnabled` property to disable escaping.
52
53
54 Affected Installations
55 ======================
56
57 Any TYPO3 instance that uses a template which contains:
58
59 * An `f:case` with `default` argument.
60 * An `f:render` with `optional="1"` and having content in the `<f:render>` tag.
61 * An `f:be.buttons.csh` with either `iconOnly` or `styleAttributes` (value irrelevant).
62 * An `f:be.tableList` with `alternateBackgroundColors` (value irrelevant).
63 * Any third-party ViewHelper which subclasses any of the classes listed above.
64 * Any third-party ViewHelper which uses `escapingInterceptorEnabled` property to disable escaping.
65
66
67 Migration
68 =========
69
70 * Remove the `default` option and change `f:case` to `f:defaultCase` for that case.
71 * Remove the tag contents of `f:render`.
72 * Remove arguments `iconOnly` and `styleAttributes` from `f:be.buttons.csh` where found.
73 * Remove argument `alternateBackgroundColors` from `f:be.tableList` where found.
74 * Update namespace of parent class in ViewHelpers subclassing any of the classes listed above.
75 * Update ViewHelper class to use `escapeChildren` and/or `escapeOutput` depending on desired behavior.
76
77 .. index:: Fluid