[FEATURE] Typolink ViewHelper
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / master / Feature-59396-TypolinkViewHelper.rst
1 ====================================
2 Feature: #59396 - TypolinkViewHelper
3 ====================================
4
5 Description
6 ===========
7
8 Adding a ViewHelper that copes with the contents of any field that was filled with a link wizard in
9 TYPO3 CMS Backend.
10 Those fields contain various parts split by a space and being escaped to provide input for the
11 typoLink function.
12 In order to use those fields natively in Fluid without the need of TypoScript in between, this ViewHelper
13 was introduced.
14 It takes the field content as a whole and can additionally take some parameters directly from Fluid.
15
16 The full parameter usage in Fluid might look like this, where {link} is the field content:
17
18 ::
19
20 <f:link.typolink parameter="{link}" target="_blank" class="ico-class" title="some title" additionalParams="" additionalAttributes="{type:'button'}">
21
22 ..
23
24 Only *parameter* is required, all other parameters are optional.
25 While passing additional parameters to the ViewHelper, following rules apply:
26
27 - target is overridden, the value from Fluid applies
28 - class is merged from the values passed from the database and those of *class*
29 - title is overridden, the value from Fluid applies
30 - additionalParams is merged from the values passed from the database and those of *additionalParams*
31 - additionalAttributes is (as usual) added to the resulting tag as *type="button"*
32
33 {link} contains *19 _blank - "testtitle with whitespace" &X=y*.
34 For the given example, the output is:
35
36 ::
37
38 <a href="index.php?id=19&X=y" title="some title" target="_blank" class="ico-class" type="button">
39
40 ..
41
42 Impact
43 ======
44
45 The new ViewHelper can be used in all new projects. There is no interference with any part of existing code.