TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:09 +02:00
commit af8cc155b5
6818 changed files with 642608 additions and 0 deletions
@@ -0,0 +1,62 @@
+..  include:: /Includes.rst.txt
+
+..  _feature-108726-1769071158:
+
+==================================================================
+Feature: #108726 - Introduce Fluid f:render.contentArea ViewHelper
+==================================================================
+
+See :issue:`108726`
+
+Description
+===========
+
+Instead of using :html:`<f:cObject>` and :html:`<f:for>` ViewHelpers to render content areas,
+the new :html:`<f:render.contentArea>` ViewHelper can be used.
+
+It allows content areas to be rendered while enabling other extensions to modify
+the output via PSR-14 EventListeners.
+
+
+This is especially useful for adding debugging wrappers or additional HTML structure
+around content areas.
+
+By default, the ViewHelper renders the content area as-is, but EventListeners
+can listen to the :php-short:`\TYPO3\CMS\Fluid\Event\ModifyRenderedContentAreaEvent` and modify the output.
+
+You need to use the `PAGEVIEW` config like this:
+
+..  code-block:: typoscript
+
+    page = PAGE
+    page.10 = PAGEVIEW
+    page.10.paths.10 = EXT:my_site_package/Resources/Private/Templates/
+
+..  code-block:: html
+    :caption: MyPage.fluid.html
+
+    <f:render.contentArea contentArea="{content.left}"/>
+    or
+    {content.left -> f:render.contentArea()}
+
+The ViewHelper also supports wrapping each content element with additional markup
+if combined with the `<f:render.record> ViewHelper <https://docs.typo3.org/permalink/t3viewhelper:typo3-fluid-render-record>`_:
+
+..  code-block:: html
+    :caption: MyPage.fluid.html
+
+    <f:render.contentArea contentArea="{content.main}" recordAs="record">
+        before {record.fullType}
+        <f:render.record record="{record}" />
+        after {record.fullType}
+    </f:render.contentArea>
+
+
+Impact
+======
+
+Theme creators are encouraged to use the :html:`<f:render.contentArea>` ViewHelper
+to allow other extensions to modify the output via EventListeners.
+
+
+..  index:: Frontend, ext:fluid