[FEATURE] Add stdWrap to htmlTag.attributes (#1559)

linawolf · web-flow · commit 9fd741cb011f · 2025-03-29T19:28:36.000+01:00
diff --git a/Documentation/TopLevelObjects/Config.rst b/Documentation/TopLevelObjects/Config.rst
@@ -503,18 +503,34 @@ Properties of 'config'
         comment in the <head> section of the page. Use this to insert a note
         like that "Programmed by My-Agency".
 
-    ..  confval:: htmlTag.attributes
+    ..  confval:: htmlTag.attributes.[attribute]
         :name: config-htmlTag-attributes
-        :type: array
+        :type: string / `stdWrap <https://docs.typo3.org/permalink/t3tsref:stdwrap>`_
         :Example: setup-config-htmltag-attributes
 
+        ..  versionchanged:: 14.0
+            It is now possible to use `stdWrap <https://docs.typo3.org/permalink/t3tsref:stdwrap>`_
+            options as a subkey for an attribute, like :ref:`userFunc <t3tsref:confval-parsefunc-userfunc>`,
+            :ref:`override <t3tsref:confval-stdwrap-override>` or
+            `Data / getText <https://docs.typo3.org/permalink/t3tsref:data-type-gettext>`_
+            via TypoScript.
+
         Sets the attributes for the :html:`<html>` tag on the page. Allows to override
         and add custom attributes via TypoScript without having to re-add the
         existing attributes generated by SiteHandling.
 
         This property supersedes the previous :typoscript:`config.htmlTag_setParams` option by providing
         a more flexible API to add attributes.
 
+        ..  code-block:: typoscript
+
+            config.htmlTag.attributes.my-attribute = 123
+
+        ..  code-block:: typoscript
+
+            config.htmlTag.attributes.my-attribute = 123
+            config.htmlTag.attributes.my-attribute.userFunc = MyVendor\MyExtension\HtmlTagEnhancer->overrideMyAttribute
+
     ..  confval:: htmlTag_setParams
         :name: config-htmlTag-setParams
         :type: :ref:`data-type-string`
