[DOCS] 7.5 Docs Part 10
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / 7.2 / Feature-20555-StripEmptyHtmlTags.rst
1 =====================================================
2 Feature: #20555 - Strip empty HTML tags in HtmlParser
3 =====================================================
4
5 Description
6 ===========
7
8 A new functionality is introduced in the HtmlParser that allows the stripping of empty HTML tags.
9
10 It can be used in the Frontend by using the :ref:`HTMLparser <t3tsref:htmlparser>` TypoScript
11 configuration of :ref:`stdWrap <t3tsref:stdwrap-htmlparser>`:
12
13 .. code-block:: typoscript
14
15         stdWrap {
16
17                 # If this is set all empty tags are stripped, unless a list of tags is provided below.
18                 HTMLparser.stripEmptyTags = 1
19
20                 # This setting can be used to filter the tags that should be stripped if they are empty.
21                 HTMLparser.stripEmptyTags.tags = h2, h3
22         }
23
24 It is also possible to use it in the
25 :ref:`HTMLparser_rte or HTMLparser_db <t3api:transformations-tsconfig-processing-htmlparser>`
26 in Page TSconfig:
27
28 .. code-block:: typoscript
29
30         # For rtehtmlarea we need to use the entry parser because otherwise the p tags will
31         # be converted to linebreaks during the RTE transformation.
32         RTE.default.proc.entryHTMLparser_db {
33                 stripEmptyTags = 1
34                 stripEmptyTags.tags = p
35
36                 # Since rtehtmlarea adds non breaking spaces in empty <p> tags we need to
37                 # tell the parser that &nbsp; should be treated as an empty string:
38                 stripEmptyTags.treatNonBreakingSpaceAsEmpty = 1
39         }
40
41 .. tip::
42
43         Please note that the HTMLparser will strip all unknown tags by default. If you **only** want
44         to strip empty tags, you need to set ``keepNonMatchedTags`` to TRUE or configure the allowed tags:
45
46 .. code-block:: typoscript
47
48         stdWrap {
49                 HTMLparser.keepNonMatchedTags = 1
50                 HTMLparser.stripEmptyTags = 1
51                 HTMLparser.stripEmptyTags.tags = h2, h3
52         }
53
54
55 Impact
56 ======
57
58 If the configuration is not set, the HtmlParser behaves like before so there is no
59 impact to existing systems (unless they already have used the stripEmptyTags setting
60 for whatever reason).
61
62