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,40 @@
+.. include:: /Includes.rst.txt
+
+.. _feature-92338:
+
+================================================================
+Feature: #92338 - Allow link text wrapping in TypolinkViewhelper
+================================================================
+
+See :issue:`92338`
+
+Description
+===========
+
+Using the :html:`f:link.typolink` ViewHelper for generating links to internal
+pages does now allow to wrap the automatically rendered link title, which
+is usually the page title of the target page.
+
+Therefore a new argument :html:`textWrap` is available, which can be used to
+define the :typoscript:`wrap` setting for the typolink.
+
+Defining :html:`<f:link.typolink parameter="123" textWrap="<span>|</span>"/>`
+will generate :html:`<a href="some/site"><span>My page title</span></a>`.
+
+.. note::
+
+   When adding additional classes to the :html:`textWrap`, ensure quotes are correctly
+   escaped: :html:`<f:link.typolink parameter="123" textWrap="<span class=\"my-class\">|</span>"/>`.
+
+If :html:`textWrap` is set, the typolink option :php:`ATagBeforeWrap` is automatically
+enabled, because the :typoscript:`wrap` should only be applied to the link text. Every
+other use case can be handled in the fluid template itself.
+
+
+Impact
+======
+
+It's now possible with the :html:`f:link.typolink` ViewHelper, to wrap the
+automatically generated link text, e.g. when linking to an internal page.
+
+.. index:: Fluid, ext:fluid