[BUGFIX] Display "required" correctly in confval tables (#750)

Resolves #747

Author: linawolf

Documentation-rendertest/Confval/ConfvalTrees.rst

@@ -135,3 +135,59 @@ Long default values
         :Example: `LLL:EXT:dashboard/Resources/Private/Language/locallang.xlf:widgets.t3news.title`
 
         Defines the title of the widget. Language references are resolved.
+
+..  confval-menu::
+    :display: table
+    :name: site-setting-definition
+    :type:
+    :required:
+
+    ..  confval:: categories
+        :type: array
+        :name: site-settings-definition-categories
+
+        ..  confval:: label
+            :type: string
+            :name: site-settings-definition-categories-label
+
+        ..  confval:: parent
+            :type: :confval:`site-settings-definition-categories` key
+            :name: site-settings-definition-categories-parent
+
+    ..  confval:: settings
+        :type: array
+        :name: site-settings-definition-settings
+
+        ..  confval:: label
+            :type: string
+            :name: site-settings-definition-settings-label
+
+        ..  confval:: description
+            :type: string
+            :name: site-settings-definition-settings-description
+
+        ..  confval:: category
+            :type: :confval:`site-settings-definition-categories` key
+            :name: site-settings-definition-settings-category
+
+        ..  confval:: type
+            :type: definition type
+            :name: site-settings-definition-settings-type
+            :required:
+
+        ..  confval:: default
+            :type: mixed
+            :name: site-settings-definition-settings-default
+            :required:
+
+            The default value must have the same type like defined in
+            site-settings-definition-settings-type.
+
+        ..  confval:: readonly
+            :type: bool
+            :name: site-settings-definition-settings-readonly
+
+            If a site setting is marked as readonly, it can be overridden only
+            by editing  the :file:`config/sites/my-site/settings.yaml` directly,
+            but not from within the editor.
+

packages/typo3-docs-theme/resources/template/body/directive/confval-menu.html.twig

@@ -14,6 +14,10 @@
                     , Type: {{ renderNode(entry.type) }}
                 {% elseif fieldName=='default' %}
                     , Default: {{ renderNode(entry.default) }}
+                {% elseif fieldName=='required' %}
+                    {%- if entry.required -%}
+                        , Required
+                    {%- endif  %}
                 {% else %}
                     {%- for key, option in entry.additionalOptions -%}
                         {%- if fieldName==key %}
@@ -66,6 +70,10 @@
                         , Type: {{ renderNode(entry.type) }}
                     {% elseif fieldName=='default' %}
                         , Default: {{ renderNode(entry.default) }}
+                    {% elseif fieldName=='required' %}
+                        {%- if entry.required -%}
+                            , Required
+                        {%- endif  %}
                     {% else %}
                         {%- for key, option in entry.additionalOptions -%}
                             {%- if fieldName==key %}
@@ -96,6 +104,10 @@
                 {{ _self.renderFieldContent(entry.type, field['max']) }}
             {% elseif fieldName=='default' %}
                 {{ _self.renderFieldContent(entry.default, field['max']) }}
+            {% elseif fieldName=='required' %}
+                {%- if entry.required -%}
+                    true
+                {%- endif  %}
             {% else %}
                 {%- for key, option in entry.additionalOptions -%}
                     {%- if fieldName==key %}
@@ -175,6 +187,8 @@
                     <th scope="col">Type</th>
                 {% elseif fieldName=='default' %}
                     <th scope="col">Default</th>
+                {% elseif fieldName=='required' %}
+                    <th scope="col">Required</th>
                 {% else %}
                     <th scope="col">{{ fieldName }}</th>
                 {% endif %}