govuk_publishing_components 12.8.0 → 12.9.0

data/node_modules/govuk-frontend/components/character-count/README.md

@@ -326,157 +326,11 @@ In order to include the images used in the components, you need to configure you
 
     app.use('/assets', express.static(path.join(__dirname, '/node_modules/govuk-frontend/assets')))
 
-## Component arguments
+## Component options
 
-If you are using Nunjucks,then macros take the following arguments
+Use options to customise the appearance, content and behaviour of a component when using a macro, for example, changing the text.
 
-**If you’re using Nunjucks macros in production be aware that using `html` arguments, or ones ending with `Html` can be a [security risk](https://en.wikipedia.org/wiki/Cross-site_scripting). More about it in the [Nunjucks documentation](https://mozilla.github.io/nunjucks/api.html#user-defined-templates-warning).**
-
-<table class="govuk-table">
-
-<thead class="govuk-table__head">
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="col">Name</th>
-
-<th class="govuk-table__header" scope="col">Type</th>
-
-<th class="govuk-table__header" scope="col">Required</th>
-
-<th class="govuk-table__header" scope="col">Description</th>
-
-</tr>
-
-</thead>
-
-<tbody class="govuk-table__body">
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">id</th>
-
-<td class="govuk-table__cell">string</td>
-
-<td class="govuk-table__cell">Yes</td>
-
-<td class="govuk-table__cell">The id of the textarea</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">describedBy</th>
-
-<td class="govuk-table__cell">string</td>
-
-<td class="govuk-table__cell">No</td>
-
-<td class="govuk-table__cell">Text or element id to add to the `aria-describedby` attribute to provide description for screenreader users.</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">name</th>
-
-<td class="govuk-table__cell">string</td>
-
-<td class="govuk-table__cell">Yes</td>
-
-<td class="govuk-table__cell">The name of the textarea, which is submitted with the form data.</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">rows</th>
-
-<td class="govuk-table__cell">string</td>
-
-<td class="govuk-table__cell">No</td>
-
-<td class="govuk-table__cell">Optional number of textarea rows (default is 5 rows).</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">value</th>
-
-<td class="govuk-table__cell">string</td>
-
-<td class="govuk-table__cell">No</td>
-
-<td class="govuk-table__cell">Optional initial value of the textarea.</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">label</th>
-
-<td class="govuk-table__cell">object</td>
-
-<td class="govuk-table__cell">Yes</td>
-
-<td class="govuk-table__cell">Arguments for the label component. See label component.</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">hint</th>
-
-<td class="govuk-table__cell">object</td>
-
-<td class="govuk-table__cell">No</td>
-
-<td class="govuk-table__cell">Arguments for the hint component (e.g. text). See hint component.</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">errorMessage</th>
-
-<td class="govuk-table__cell">object</td>
-
-<td class="govuk-table__cell">No</td>
-
-<td class="govuk-table__cell">Arguments for the errorMessage component (e.g. text). See errorMessage component.</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">classes</th>
-
-<td class="govuk-table__cell">string</td>
-
-<td class="govuk-table__cell">No</td>
-
-<td class="govuk-table__cell">Optional additional classes to add to the textarea tag.</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">attributes</th>
-
-<td class="govuk-table__cell">object</td>
-
-<td class="govuk-table__cell">No</td>
-
-<td class="govuk-table__cell">Any extra HTML attributes (for example data attributes) to add to the textarea tag.</td>
-
-</tr>
-
-</tbody>
-
-</table>
-
-**If you’re using Nunjucks macros in production be aware that using `html` arguments, or ones ending with `Html` can be a [security risk](https://en.wikipedia.org/wiki/Cross-site_scripting). More about it in the [Nunjucks documentation](https://mozilla.github.io/nunjucks/api.html#user-defined-templates-warning).**
+See [options table](https://design-system.service.gov.uk/components/character-count/#options-example-default) for details.
 
 ### Setting up Nunjucks views and paths
 

data/node_modules/govuk-frontend/components/character-count/character-count.js

@@ -937,7 +937,7 @@ if (detect) return
 
     if (detect) return
 
-    // Polyfill from https://raw.githubusercontent.com/Financial-Times/polyfill-service/8717a9e04ac7aff99b4980fbedead98036b0929a/packages/polyfill-library/polyfills/Element/prototype/classList/polyfill.js
+    // Polyfill from https://cdn.polyfill.io/v2/polyfill.js?features=Element.prototype.classList&flags=always
     (function (global) {
       var dpSupport = true;
       var defineGetter = function (object, name, fn, configurable) {

data/node_modules/govuk-frontend/components/checkboxes/README.md

@@ -691,265 +691,11 @@ In order to include the images used in the components, you need to configure you
 
     app.use('/assets', express.static(path.join(__dirname, '/node_modules/govuk-frontend/assets')))
 
-## Component arguments
+## Component options
 
-If you are using Nunjucks,then macros take the following arguments
+Use options to customise the appearance, content and behaviour of a component when using a macro, for example, changing the text.
 
-**If you’re using Nunjucks macros in production be aware that using `html` arguments, or ones ending with `Html` can be a [security risk](https://en.wikipedia.org/wiki/Cross-site_scripting). More about it in the [Nunjucks documentation](https://mozilla.github.io/nunjucks/api.html#user-defined-templates-warning).**
-
-<table class="govuk-table">
-
-<thead class="govuk-table__head">
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="col">Name</th>
-
-<th class="govuk-table__header" scope="col">Type</th>
-
-<th class="govuk-table__header" scope="col">Required</th>
-
-<th class="govuk-table__header" scope="col">Description</th>
-
-</tr>
-
-</thead>
-
-<tbody class="govuk-table__body">
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">fieldset</th>
-
-<td class="govuk-table__cell">object</td>
-
-<td class="govuk-table__cell">No</td>
-
-<td class="govuk-table__cell">Arguments for the fieldset component (e.g. legend). See <a href="../fieldset/README.md#component-arguments">fieldset</a> component.</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">hint</th>
-
-<td class="govuk-table__cell">object</td>
-
-<td class="govuk-table__cell">No</td>
-
-<td class="govuk-table__cell">Arguments for the hint component (e.g. text). See <a href="../hint/README.md#component-arguments">hint</a> component.</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">errorMessage</th>
-
-<td class="govuk-table__cell">object</td>
-
-<td class="govuk-table__cell">No</td>
-
-<td class="govuk-table__cell">Arguments for the errorMessage component (e.g. text). See <a href="../error-message/README.md#component-arguments">errorMessage</a> component.</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">idPrefix</th>
-
-<td class="govuk-table__cell">string</td>
-
-<td class="govuk-table__cell">No</td>
-
-<td class="govuk-table__cell">String to prefix id for each checkbox item if no id is specified on each item. If`idPrefix` is not passed, fallback to using the name attribute instead.</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">name</th>
-
-<td class="govuk-table__cell">string</td>
-
-<td class="govuk-table__cell">Yes</td>
-
-<td class="govuk-table__cell">Name attribute for each checkbox item.</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">items</th>
-
-<td class="govuk-table__cell">array</td>
-
-<td class="govuk-table__cell">Yes</td>
-
-<td class="govuk-table__cell">Array of checkbox items objects.</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">items.{}.text (or) items.{}.html</th>
-
-<td class="govuk-table__cell">string</td>
-
-<td class="govuk-table__cell">Yes</td>
-
-<td class="govuk-table__cell">Text or HTML to use within each checkbox item label. If `html` is provided, the `text` argument will be ignored.</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">items.{}.id</th>
-
-<td class="govuk-table__cell">string</td>
-
-<td class="govuk-table__cell">No</td>
-
-<td class="govuk-table__cell">Specific id attribute for the checkbox item. If ommited, then `idPrefix` string will be applied.</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">items.{}.name</th>
-
-<td class="govuk-table__cell">string</td>
-
-<td class="govuk-table__cell">Yes</td>
-
-<td class="govuk-table__cell">Specific name for the checkbox item. If ommited, then component global `name` string will be applied.</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">items.{}.value</th>
-
-<td class="govuk-table__cell">string</td>
-
-<td class="govuk-table__cell">Yes</td>
-
-<td class="govuk-table__cell">Value for the checkbox input.</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">items.{}.label</th>
-
-<td class="govuk-table__cell">object</td>
-
-<td class="govuk-table__cell">No</td>
-
-<td class="govuk-table__cell">Provide additional attributes and classes to each checkbox item label. See [label](../label/README.md#component-arguments) component for more details.</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">items.{}.hint</th>
-
-<td class="govuk-table__cell">object</td>
-
-<td class="govuk-table__cell">No</td>
-
-<td class="govuk-table__cell">Provide optional hint to each checkbox item. See `hint` component for more details.</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">items.{}.checked</th>
-
-<td class="govuk-table__cell">boolean</td>
-
-<td class="govuk-table__cell">No</td>
-
-<td class="govuk-table__cell">If true, checkbox will be checked.</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">items.{}.conditional</th>
-
-<td class="govuk-table__cell">boolean</td>
-
-<td class="govuk-table__cell">No</td>
-
-<td class="govuk-table__cell">If true, content provided will be revealed when the item is checked.</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">items.{}.conditional.html</th>
-
-<td class="govuk-table__cell">boolean</td>
-
-<td class="govuk-table__cell">No</td>
-
-<td class="govuk-table__cell">Provide content for the conditional reveal.</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">items.{}.disabled</th>
-
-<td class="govuk-table__cell">boolean</td>
-
-<td class="govuk-table__cell">No</td>
-
-<td class="govuk-table__cell">If true, checkbox will be disabled.</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">items.{}.attributes</th>
-
-<td class="govuk-table__cell">object</td>
-
-<td class="govuk-table__cell">No</td>
-
-<td class="govuk-table__cell">Any extra HTML attributes (for example data attributes) to add to the checkbox input tag.</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">classes</th>
-
-<td class="govuk-table__cell">string</td>
-
-<td class="govuk-table__cell">No</td>
-
-<td class="govuk-table__cell">Optional additional classes to add to the checkboxes container.</td>
-
-</tr>
-
-<tr class="govuk-table__row">
-
-<th class="govuk-table__header" scope="row">attributes</th>
-
-<td class="govuk-table__cell">object</td>
-
-<td class="govuk-table__cell">No</td>
-
-<td class="govuk-table__cell">Any extra HTML attributes (for example data attributes) to add to the checkboxes container.</td>
-
-</tr>
-
-</tbody>
-
-</table>
-
-**If you’re using Nunjucks macros in production be aware that using `html` arguments, or ones ending with `Html` can be a [security risk](https://en.wikipedia.org/wiki/Cross-site_scripting). More about it in the [Nunjucks documentation](https://mozilla.github.io/nunjucks/api.html#user-defined-templates-warning).**
+See [options table](https://design-system.service.gov.uk/components/checkboxes/#options-example-default) for details.
 
 ### Setting up Nunjucks views and paths
 

data/node_modules/govuk-frontend/components/checkboxes/checkboxes.js

@@ -937,7 +937,7 @@ if (detect) return
 
     if (detect) return
 
-    // Polyfill from https://raw.githubusercontent.com/Financial-Times/polyfill-service/8717a9e04ac7aff99b4980fbedead98036b0929a/packages/polyfill-library/polyfills/Element/prototype/classList/polyfill.js
+    // Polyfill from https://cdn.polyfill.io/v2/polyfill.js?features=Element.prototype.classList&flags=always
     (function (global) {
       var dpSupport = true;
       var defineGetter = function (object, name, fn, configurable) {

data/node_modules/govuk-frontend/components/checkboxes/template.njk

@@ -18,6 +18,9 @@
   {% endif %}
 {% endfor %}
 
+{#- fieldset is false by default -#}
+{% set hasFieldset = true if params.fieldset else false %}
+
 {#- Capture the HTML so we can optionally nest it in a fieldset -#}
 {% set innerHtml %}
 {% if params.hint %}
@@ -54,6 +57,8 @@
       <input class="govuk-checkboxes__input" id="{{ id }}" name="{{ name }}" type="checkbox" value="{{ item.value }}"
       {{-" checked" if item.checked }}
       {{-" disabled" if item.disabled }}
+      {#- fieldset is false by default -#}
+      {%- if (not hasFieldset) and ((describedBy | length) > 0) %} aria-describedby="{{ describedBy }}"{% endif -%}
       {%- if item.conditional %} data-aria-controls="{{ conditionalId }}"{% endif -%}
       {%- if hasHint %} aria-describedby="{{ itemHintId }}"{% endif -%}
       {%- for attribute, value in item.attributes %} {{ attribute }}="{{ value }}"{% endfor -%}>