govuk_publishing_components 34.7.0 → 34.8.0

data/node_modules/govuk-frontend/govuk/components/summary-list/macro-options.json

@@ -98,6 +98,116 @@
             }
         ]
     },
+    {
+        "name": "card",
+        "type": "object",
+        "required": false,
+        "description": "Options for the summary card. If any of these options are present, a summary card will wrap around the summary list.",
+        "params": [
+            {
+                "name": "title",
+                "type": "object",
+                "required": false,
+                "description": "Data for the summary card header.",
+                "params": [
+                    {
+                        "name": "text",
+                        "type": "string",
+                        "required": false,
+                        "description": "Text to use within the each title. If `html` is provided, the `text` option will be ignored."
+                    },
+                    {
+                        "name": "html",
+                        "type": "string",
+                        "required": false,
+                        "description": "Text to use within the each title. If `html` is provided, the `text` option will be ignored."
+                    },
+                    {
+                        "name": "headingLevel",
+                        "type": "integer",
+                        "required": false,
+                        "description": "Heading level, from `1` to `6`. Default is `2`."
+                    },
+                    {
+                        "name": "classes",
+                        "type": "string",
+                        "required": false,
+                        "description": "Classes to add to the title wrapper."
+                    }
+                ]
+            },
+            {
+                "name": "actions",
+                "type": "object",
+                "required": false,
+                "description": "Data for the summary card actions",
+                "params": [
+                    {
+                        "name": "items",
+                        "type": "array",
+                        "required": false,
+                        "description": "Array of action item objects.",
+                        "params": [
+                            {
+                                "name": "href",
+                                "type": "string",
+                                "required": true,
+                                "description": "The value of the link's `href` attribute for an action item."
+                            },
+                            {
+                                "name": "text",
+                                "type": "string",
+                                "required": true,
+                                "description": "If `html` is set, this is not required. Text to use within each action item. If `html` is provided, the `text` option will be ignored."
+                            },
+                            {
+                                "name": "html",
+                                "type": "string",
+                                "required": true,
+                                "description": "If `text` is set, this is not required. HTML to use within the each action item. If `html` is provided, the `text` option will be ignored."
+                            },
+                            {
+                                "name": "visuallyHiddenText",
+                                "type": "string",
+                                "required": false,
+                                "description": "Actions rely on context from the surrounding content so may require additional accessible text. Text supplied to this option is appended to the end. Use `html` for more complicated scenarios."
+                            },
+                            {
+                                "name": "classes",
+                                "type": "string",
+                                "required": false,
+                                "description": "Classes to add to the action item."
+                            },
+                            {
+                                "name": "attributes",
+                                "type": "object",
+                                "required": false,
+                                "description": "HTML attributes (for example data attributes) to add to the action item."
+                            }
+                        ]
+                    },
+                    {
+                        "name": "classes",
+                        "type": "string",
+                        "required": false,
+                        "description": "Classes to add to the actions wrapper."
+                    }
+                ]
+            },
+            {
+                "name": "classes",
+                "type": "string",
+                "required": false,
+                "description": "Classes to add to the container."
+            },
+            {
+                "name": "attributes",
+                "type": "object",
+                "required": false,
+                "description": "HTML attributes (for example data attributes) to add to the container."
+            }
+        ]
+    },
     {
         "name": "classes",
         "type": "string",

data/node_modules/govuk-frontend/govuk/components/summary-list/template.njk

@@ -7,38 +7,82 @@
   </a>
 {% endmacro -%}
 
+{%- macro _summaryCard(params) %}
+  {%- set headingLevel = params.title.headingLevel if params.title.headingLevel else 2 -%}
+
+  <div class="govuk-summary-card {%- if params.classes %} {{ params.classes }}{% endif %}"{% for attribute, value in params.attributes %} {{attribute}}="{{value}}"{% endfor %}>
+    <div class="govuk-summary-card__title-wrapper">
+      {%- if params.title -%}
+        <h{{ headingLevel }} class="govuk-summary-card__title {%- if params.title.classes %} {{ params.title.classes }}{% endif %}">
+          {{- params.title.html | safe if params.title.html else params.title.text -}}
+        </h{{ headingLevel }}>
+      {%- endif -%}
+
+      {%- if params.actions.items.length -%}
+        {%- if params.actions.items.length == 1 -%}
+          <div class="govuk-summary-card__actions {%- if params.actions.classes %} {{ params.actions.classes }}{% endif %}">
+            {{- _actionLink(params.actions.items[0]) -}}
+          </div>
+        {%- else -%}
+          <ul class="govuk-summary-card__actions {%- if params.actions.classes %} {{ params.actions.classes }}{% endif %}">
+            {%- for action in params.actions.items -%}
+              <li class="govuk-summary-card__action">
+                {{- _actionLink(action) -}}
+              </li>
+            {%- endfor -%}
+          </ul>
+        {% endif -%}
+      {%- endif -%}
+    </div>
+
+    <div class="govuk-summary-card__content">
+      {{- caller() -}}
+    </div>
+  </div>
+{% endmacro -%}
+
 {# Determine if we need 2 or 3 columns #}
 {% set anyRowHasActions = false %}
 {% for row in params.rows %}
   {% set anyRowHasActions = true if row.actions.items | length else anyRowHasActions %}
 {% endfor -%}
 
-<dl class="govuk-summary-list {%- if params.classes %} {{ params.classes }}{% endif %}"{% for attribute, value in params.attributes %} {{attribute}}="{{value}}"{% endfor %}>
-  {% for row in params.rows %}
-    {% if row %}
-      <div class="govuk-summary-list__row {%- if anyRowHasActions and not row.actions.items %} govuk-summary-list__row--no-actions{% endif %} {%- if row.classes %} {{ row.classes }}{% endif %}">
-        <dt class="govuk-summary-list__key {%- if row.key.classes %} {{ row.key.classes }}{% endif %}">
-          {{ row.key.html | safe if row.key.html else row.key.text }}
-        </dt>
-        <dd class="govuk-summary-list__value {%- if row.value.classes %} {{ row.value.classes }}{% endif %}">
-          {{ row.value.html | indent(8) | trim | safe if row.value.html else row.value.text }}
-        </dd>
-        {% if row.actions.items.length %}
-          <dd class="govuk-summary-list__actions {%- if row.actions.classes %} {{ row.actions.classes }}{% endif %}">
-            {% if row.actions.items.length == 1 %}
-              {{ _actionLink(row.actions.items[0]) | indent(12) | trim }}
-            {% else %}
-              <ul class="govuk-summary-list__actions-list">
-                {%- for action in row.actions.items -%}
-                  <li class="govuk-summary-list__actions-list-item">
-                    {{- _actionLink(action) | indent(18) | trim -}}
-                  </li>
-                {%- endfor -%}
-              </ul>
-            {% endif %}
+{%- set summaryList -%}
+  <dl class="govuk-summary-list {%- if params.classes %} {{ params.classes }}{% endif %}"{% for attribute, value in params.attributes %} {{attribute}}="{{value}}"{% endfor %}>
+    {% for row in params.rows %}
+      {% if row %}
+        <div class="govuk-summary-list__row {%- if anyRowHasActions and not row.actions.items %} govuk-summary-list__row--no-actions{% endif %} {%- if row.classes %} {{ row.classes }}{% endif %}">
+          <dt class="govuk-summary-list__key {%- if row.key.classes %} {{ row.key.classes }}{% endif %}">
+            {{ row.key.html | indent(4 if params.card else 0) | safe if row.key.html else row.key.text }}
+          </dt>
+          <dd class="govuk-summary-list__value {%- if row.value.classes %} {{ row.value.classes }}{% endif %}">
+            {{ row.value.html | indent(12 if params.card else 8) | trim | safe if row.value.html else row.value.text }}
           </dd>
-        {% endif %}
-      </div>
-    {% endif %}
-  {% endfor %}
-</dl>
+          {% if row.actions.items.length %}
+            <dd class="govuk-summary-list__actions {%- if row.actions.classes %} {{ row.actions.classes }}{% endif %}">
+              {% if row.actions.items.length == 1 %}
+                {{ _actionLink(row.actions.items[0]) | indent(16 if params.card else 12) | trim }}
+              {% else %}
+                <ul class="govuk-summary-list__actions-list">
+                  {%- for action in row.actions.items -%}
+                    <li class="govuk-summary-list__actions-list-item">
+                      {{- _actionLink(action) | indent(22 if params.card else 18) | trim -}}
+                    </li>
+                  {%- endfor -%}
+                </ul>
+              {% endif %}
+            </dd>
+          {% endif %}
+        </div>
+      {% endif %}
+    {% endfor %}
+  </dl>
+{%- endset %}
+
+{%- if params.card -%}
+  {% call _summaryCard(params.card) -%}
+    {{ summaryList | safe }}
+  {%- endcall %}
+{%- else -%}
+  {{ summaryList | safe }}
+{%- endif %}