govuk_tech_docs 6.6.0.rc.local.tested → 6.6.0

data/node_modules/govuk-frontend/dist/govuk/components/details/fixtures.json

@@ -0,0 +1,133 @@
+{
+    "component": "details",
+    "fixtures": [
+        {
+            "name": "default",
+            "options": {
+                "summaryText": "Help with nationality",
+                "text": "We need to know your nationality so we can work out which elections you’re entitled to vote in. If you can’t provide your nationality, you’ll have to send copies of identity documents through the post."
+            },
+            "hidden": false,
+            "description": "",
+            "pageTemplateOptions": {},
+            "screenshot": true,
+            "html": "<details class=\"govuk-details\">\n  <summary class=\"govuk-details__summary\">\n    <span class=\"govuk-details__summary-text\">\n      Help with nationality\n    </span>\n  </summary>\n  <div class=\"govuk-details__text\">\n    We need to know your nationality so we can work out which elections you’re entitled to vote in. If you can’t provide your nationality, you’ll have to send copies of identity documents through the post.\n  </div>\n</details>"
+        },
+        {
+            "name": "expanded",
+            "options": {
+                "id": "help-with-nationality",
+                "summaryText": "Help with nationality",
+                "text": "We need to know your nationality so we can work out which elections you’re entitled to vote in. If you can’t provide your nationality, you’ll have to send copies of identity documents through the post.",
+                "open": true
+            },
+            "hidden": false,
+            "description": "",
+            "pageTemplateOptions": {},
+            "screenshot": true,
+            "html": "<details id=\"help-with-nationality\" class=\"govuk-details\" open>\n  <summary class=\"govuk-details__summary\">\n    <span class=\"govuk-details__summary-text\">\n      Help with nationality\n    </span>\n  </summary>\n  <div class=\"govuk-details__text\">\n    We need to know your nationality so we can work out which elections you’re entitled to vote in. If you can’t provide your nationality, you’ll have to send copies of identity documents through the post.\n  </div>\n</details>"
+        },
+        {
+            "name": "id",
+            "options": {
+                "id": "my-details-element",
+                "summaryText": "Expand this section",
+                "text": "Here are some more details"
+            },
+            "hidden": true,
+            "description": "",
+            "pageTemplateOptions": {},
+            "screenshot": false,
+            "html": "<details id=\"my-details-element\" class=\"govuk-details\">\n  <summary class=\"govuk-details__summary\">\n    <span class=\"govuk-details__summary-text\">\n      Expand this section\n    </span>\n  </summary>\n  <div class=\"govuk-details__text\">\n    Here are some more details\n  </div>\n</details>"
+        },
+        {
+            "name": "html as text",
+            "options": {
+                "summaryText": "Expand this section",
+                "text": "More about the greater than symbol (>)"
+            },
+            "hidden": true,
+            "description": "",
+            "pageTemplateOptions": {},
+            "screenshot": false,
+            "html": "<details class=\"govuk-details\">\n  <summary class=\"govuk-details__summary\">\n    <span class=\"govuk-details__summary-text\">\n      Expand this section\n    </span>\n  </summary>\n  <div class=\"govuk-details__text\">\n    More about the greater than symbol (&gt;)\n  </div>\n</details>"
+        },
+        {
+            "name": "html",
+            "options": {
+                "summaryText": "Expand this section",
+                "html": "More about <b>bold text</b>"
+            },
+            "hidden": true,
+            "description": "",
+            "pageTemplateOptions": {},
+            "screenshot": false,
+            "html": "<details class=\"govuk-details\">\n  <summary class=\"govuk-details__summary\">\n    <span class=\"govuk-details__summary-text\">\n      Expand this section\n    </span>\n  </summary>\n  <div class=\"govuk-details__text\">\n    More about <b>bold text</b>\n  </div>\n</details>"
+        },
+        {
+            "name": "summary html as text",
+            "options": {
+                "summaryText": "The greater than symbol (>) is the best",
+                "text": "Here are some more details"
+            },
+            "hidden": true,
+            "description": "",
+            "pageTemplateOptions": {},
+            "screenshot": false,
+            "html": "<details class=\"govuk-details\">\n  <summary class=\"govuk-details__summary\">\n    <span class=\"govuk-details__summary-text\">\n      The greater than symbol (&gt;) is the best\n    </span>\n  </summary>\n  <div class=\"govuk-details__text\">\n    Here are some more details\n  </div>\n</details>"
+        },
+        {
+            "name": "summary html",
+            "options": {
+                "summaryHtml": "Use <b>bold text</b> sparingly",
+                "text": "Here are some more details"
+            },
+            "hidden": true,
+            "description": "",
+            "pageTemplateOptions": {},
+            "screenshot": false,
+            "html": "<details class=\"govuk-details\">\n  <summary class=\"govuk-details__summary\">\n    <span class=\"govuk-details__summary-text\">\n      Use <b>bold text</b> sparingly\n    </span>\n  </summary>\n  <div class=\"govuk-details__text\">\n    Here are some more details\n  </div>\n</details>"
+        },
+        {
+            "name": "classes",
+            "options": {
+                "classes": "some-additional-class",
+                "text": "Here are some more details",
+                "summaryText": "Expand me"
+            },
+            "hidden": true,
+            "description": "",
+            "pageTemplateOptions": {},
+            "screenshot": false,
+            "html": "<details class=\"govuk-details some-additional-class\">\n  <summary class=\"govuk-details__summary\">\n    <span class=\"govuk-details__summary-text\">\n      Expand me\n    </span>\n  </summary>\n  <div class=\"govuk-details__text\">\n    Here are some more details\n  </div>\n</details>"
+        },
+        {
+            "name": "attributes",
+            "options": {
+                "text": "Here are some more details",
+                "summaryText": "Expand me",
+                "attributes": {
+                    "data-some-data-attribute": "i-love-data",
+                    "another-attribute": "foo"
+                }
+            },
+            "hidden": true,
+            "description": "",
+            "pageTemplateOptions": {},
+            "screenshot": false,
+            "html": "<details class=\"govuk-details\" data-some-data-attribute=\"i-love-data\" another-attribute=\"foo\">\n  <summary class=\"govuk-details__summary\">\n    <span class=\"govuk-details__summary-text\">\n      Expand me\n    </span>\n  </summary>\n  <div class=\"govuk-details__text\">\n    Here are some more details\n  </div>\n</details>"
+        },
+        {
+            "name": "with html",
+            "options": {
+                "summaryText": "Where to find your National Insurance Number",
+                "html": "Your National Insurance number can be found on\n<ul>\n  <li>your National Insurance card</li>\n  <li>your payslip</li>\n  <li>P60</li>\n  <li>benefits information</li>\n  <li>tax return</li>\n</ul>\n"
+            },
+            "hidden": false,
+            "description": "",
+            "pageTemplateOptions": {},
+            "screenshot": false,
+            "html": "<details class=\"govuk-details\">\n  <summary class=\"govuk-details__summary\">\n    <span class=\"govuk-details__summary-text\">\n      Where to find your National Insurance Number\n    </span>\n  </summary>\n  <div class=\"govuk-details__text\">\n    Your National Insurance number can be found on\n<ul>\n  <li>your National Insurance card</li>\n  <li>your payslip</li>\n  <li>P60</li>\n  <li>benefits information</li>\n  <li>tax return</li>\n</ul>\n\n  </div>\n</details>"
+        }
+    ]
+}

data/node_modules/govuk-frontend/dist/govuk/components/details/implementation.md

@@ -0,0 +1,87 @@
+## Implementation notes
+
+### Styling in older browsers
+
+#### Browsers with support for `type=module`, `<details>` and feature queries
+
+https://browsersl.ist/#q=supports+details+and+supports+css-featurequeries+and+supports+es6-module&region=GB
+
+Previously, we provided a polyfill for older browsers which do not support the
+`<details>` component. Since most browsers now DO support `<details>`, we've
+removed that polyfill, and we need to make sure browsers which don't support
+`<details>` don't use any styles that make them look interactable.
+
+By wrapping these styles in a feature query, we can capture the vast majority of
+browsers which have full support.
+
+#### Browsers that support `type=module` and feature queries but not `<details>`
+
+https://browsersl.ist/#q=supports+es6-module+and+not+supports+details+and+supports+css-featurequeries&region=GB
+
+This only affects Edge 16 - 18. We filter these out of the support query by
+checking for `-ms-ime-align: auto`, which isn't supported by any other browsers.
+
+#### Browsers that support `<details>` but not `type=module` or feature queries
+
+https://browsersl.ist/#q=supports+details+and+not+supports+css-featurequeries+and+not+supports+es6-module&region=GB
+
+These will default to their native styling of the `<details>` element, with a
+few of our spacing and font styles.
+
+#### Browsers which don't support `<details>`, `type=module` or feature queries
+
+https://browsersl.ist/#q=%3E0.0000001%25+and+not+supports+details+and+not+supports+es6-module+and+not+supports+css-featurequeries&region=GB
+
+This is largely IE 8 - 11.
+
+We can account for IE by styling them like inset text, via a `@media screen\0`
+hack that no other browser supports.
+
+#### Browsers that support feature queries, but not `<details>` or `type=module`
+
+https://browsersl.ist/#q=supports+css-featurequeries+and+not+supports+details+and+not+supports+es6-module&region=GB
+
+This is the only gap, as these browsers will get styled to look interactable,
+even though they aren't. This is largely Opera Mini.
+
+### Marker styling
+
+Firefox uses display: list-item to show the arrow marker for the summary
+element.
+
+Unfortunately we want to use `display: inline-block` to 'shrink-wrap' the focus
+outline around the summary text, which means that the arrow no longer shows up.
+
+Previously in GOV.UK Elements we resolved this by targeting Firefox specifically
+and reverting to `display: list-item`:
+
+```scss
+@-moz-document regexp(".*") {
+  details summary:not([tabindex]) {
+    // Allow duplicate properties, override the summary display property
+    // scss-lint:disable DuplicateProperty
+    display: list-item;
+    display: revert;
+  }
+}
+```
+
+However, `@-moz-document` has been removed in Firefox nightly as of 29th Nov
+2017 so with this in mind we have taken a different approach, hiding the
+browser's marker and injecting and styling our own one across all browsers
+instead.
+
+This also gives us more control over the styling of the marker, allowing us for
+example to align the summary and disclosed text correctly across all browsers.
+
+The downside of this approach is that older browsers that require a polyfill for
+the details element will display the marker even when Javascript is disabled.
+Whilst this is not perfect, it is a cosmetic issue and the user will still be
+able to access the disclosed content.
+
+For the arrows themselves, we originally tried using unicode glyphs –
+specifically \25B6 (Black right-pointing triangle) and 25BC (Black down-pointing
+triangle) but Android insists on substituting the the former for an emoji even
+when the \00FE0E modifier is applied. Sad face.
+
+Hence the border-based triangles we are using today.

data/node_modules/govuk-frontend/dist/govuk/components/details/macro-options.json

@@ -0,0 +1,56 @@
+[
+    {
+        "name": "summaryText",
+        "type": "string",
+        "required": true,
+        "description": "If `summmaryHtml` is set, this is not required. Text to use within the summary element (the visible part of the details element). If `summaryHtml` is provided, the `summaryText` option will be ignored."
+    },
+    {
+        "name": "summaryHtml",
+        "type": "string",
+        "required": true,
+        "description": "If `summmaryText` is set, this is not required. HTML to use within the summary element (the visible part of the details element). If `summaryHtml` is provided, the `summaryText` option will be ignored."
+    },
+    {
+        "name": "text",
+        "type": "string",
+        "required": true,
+        "description": "If `html` is set, this is not required. Text to use within the disclosed part of the details element. 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 disclosed part of the details element. If `html` is provided, the `text` option will be ignored."
+    },
+    {
+        "name": "caller",
+        "type": "nunjucks-block",
+        "required": false,
+        "description": "Not strictly a parameter but [Nunjucks code convention](https://mozilla.github.io/nunjucks/templating.html#call). Using a `call` block enables you to call a macro with all the text inside the tag. This is helpful if you want to pass a lot of content into a macro. To use it, you will need to wrap the entire details component in a `call` block."
+    },
+    {
+        "name": "id",
+        "type": "string",
+        "required": false,
+        "description": "ID to add to the details element."
+    },
+    {
+        "name": "open",
+        "type": "boolean",
+        "required": false,
+        "description": "If `true`, details element will be expanded."
+    },
+    {
+        "name": "classes",
+        "type": "string",
+        "required": false,
+        "description": "Classes to add to the `<details>` element."
+    },
+    {
+        "name": "attributes",
+        "type": "object",
+        "required": false,
+        "description": "HTML attributes (for example data attributes) to add to the `<details>` element."
+    }
+]

data/node_modules/govuk-frontend/dist/govuk/components/details/macro.njk

@@ -0,0 +1,3 @@
+{% macro govukDetails(params) %}
+  {%- include "./template.njk" -%}
+{% endmacro %}

data/node_modules/govuk-frontend/dist/govuk/components/details/template-default.html

@@ -0,0 +1,10 @@
+<details class="govuk-details">
+  <summary class="govuk-details__summary">
+    <span class="govuk-details__summary-text">
+      Help with nationality
+    </span>
+  </summary>
+  <div class="govuk-details__text">
+    We need to know your nationality so we can work out which elections you’re entitled to vote in. If you can’t provide your nationality, you’ll have to send copies of identity documents through the post.
+  </div>
+</details>

data/node_modules/govuk-frontend/dist/govuk/components/details/template-expanded.html

@@ -0,0 +1,10 @@
+<details id="help-with-nationality" class="govuk-details" open>
+  <summary class="govuk-details__summary">
+    <span class="govuk-details__summary-text">
+      Help with nationality
+    </span>
+  </summary>
+  <div class="govuk-details__text">
+    We need to know your nationality so we can work out which elections you’re entitled to vote in. If you can’t provide your nationality, you’ll have to send copies of identity documents through the post.
+  </div>
+</details>

data/node_modules/govuk-frontend/dist/govuk/components/details/template-with-html.html

@@ -0,0 +1,18 @@
+<details class="govuk-details">
+  <summary class="govuk-details__summary">
+    <span class="govuk-details__summary-text">
+      Where to find your National Insurance Number
+    </span>
+  </summary>
+  <div class="govuk-details__text">
+    Your National Insurance number can be found on
+<ul>
+  <li>your National Insurance card</li>
+  <li>your payslip</li>
+  <li>P60</li>
+  <li>benefits information</li>
+  <li>tax return</li>
+</ul>
+
+  </div>
+</details>

data/node_modules/govuk-frontend/dist/govuk/components/details/template.njk

@@ -0,0 +1,14 @@
+{% from "../../macros/attributes.njk" import govukAttributes -%}
+
+<details {%- if params.id %} id="{{ params.id }}"{% endif %} class="govuk-details {%- if params.classes %} {{ params.classes }}{% endif %}"
+  {{- govukAttributes(params.attributes) -}}
+  {{- " open" if params.open }}>
+  <summary class="govuk-details__summary">
+    <span class="govuk-details__summary-text">
+      {{ params.summaryHtml | safe | trim | indent(6) if params.summaryHtml else params.summaryText }}
+    </span>
+  </summary>
+  <div class="govuk-details__text">
+    {{ caller() if caller else (params.html | safe if params.html else params.text) }}
+  </div>
+</details>

data/node_modules/govuk-frontend/dist/govuk/components/error-message/README.md

@@ -0,0 +1,15 @@
+# Error message
+
+## Installation
+
+See the [main README quick start guide](https://github.com/alphagov/govuk-frontend#quick-start) for how to install this component.
+
+## Guidance and Examples
+
+Find out when to use the error message component in your service in the [GOV.UK Design System](https://design-system.service.gov.uk/components/error-message).
+
+## Component options
+
+Use options to customise the appearance, content and behaviour of a component when using a macro, for example, changing the text.
+
+See [options table](https://design-system.service.gov.uk/components/error-message/#options-error-message-example) for details.

data/node_modules/govuk-frontend/dist/govuk/components/error-message/fixtures.json

@@ -0,0 +1,113 @@
+{
+    "component": "error-message",
+    "fixtures": [
+        {
+            "name": "default",
+            "options": {
+                "text": "Error message about full name goes here"
+            },
+            "hidden": false,
+            "description": "",
+            "pageTemplateOptions": {},
+            "screenshot": true,
+            "html": "<p class=\"govuk-error-message\">\n  <span class=\"govuk-visually-hidden\">Error:</span> Error message about full name goes here\n</p>"
+        },
+        {
+            "name": "translated",
+            "options": {
+                "visuallyHiddenText": "",
+                "html": "<span class=\"govuk-visually-hidden\">Gwall:</span> Neges gwall am yr enw llawn yn mynd yma"
+            },
+            "hidden": false,
+            "description": "",
+            "pageTemplateOptions": {},
+            "screenshot": false,
+            "html": "<p class=\"govuk-error-message\">\n  <span class=\"govuk-visually-hidden\">Gwall:</span> Neges gwall am yr enw llawn yn mynd yma\n</p>"
+        },
+        {
+            "name": "id",
+            "options": {
+                "id": "my-error-message-id",
+                "text": "This is an error message"
+            },
+            "hidden": true,
+            "description": "",
+            "pageTemplateOptions": {},
+            "screenshot": false,
+            "html": "<p id=\"my-error-message-id\" class=\"govuk-error-message\">\n  <span class=\"govuk-visually-hidden\">Error:</span> This is an error message\n</p>"
+        },
+        {
+            "name": "classes",
+            "options": {
+                "classes": "custom-class",
+                "text": "This is an error message"
+            },
+            "hidden": true,
+            "description": "",
+            "pageTemplateOptions": {},
+            "screenshot": false,
+            "html": "<p class=\"govuk-error-message custom-class\">\n  <span class=\"govuk-visually-hidden\">Error:</span> This is an error message\n</p>"
+        },
+        {
+            "name": "html as text",
+            "options": {
+                "text": "Unexpected > in body"
+            },
+            "hidden": true,
+            "description": "",
+            "pageTemplateOptions": {},
+            "screenshot": false,
+            "html": "<p class=\"govuk-error-message\">\n  <span class=\"govuk-visually-hidden\">Error:</span> Unexpected &gt; in body\n</p>"
+        },
+        {
+            "name": "html",
+            "options": {
+                "html": "Unexpected <b>bold text</b> in body copy"
+            },
+            "hidden": true,
+            "description": "",
+            "pageTemplateOptions": {},
+            "screenshot": false,
+            "html": "<p class=\"govuk-error-message\">\n  <span class=\"govuk-visually-hidden\">Error:</span> Unexpected <b>bold text</b> in body copy\n</p>"
+        },
+        {
+            "name": "attributes",
+            "options": {
+                "text": "This is an error message",
+                "attributes": {
+                    "data-test": "attribute",
+                    "id": "my-error-message"
+                }
+            },
+            "hidden": true,
+            "description": "",
+            "pageTemplateOptions": {},
+            "screenshot": false,
+            "html": "<p class=\"govuk-error-message\" data-test=\"attribute\" id=\"my-error-message\">\n  <span class=\"govuk-visually-hidden\">Error:</span> This is an error message\n</p>"
+        },
+        {
+            "name": "with visually hidden text",
+            "options": {
+                "text": "Rhowch eich enw llawn",
+                "visuallyHiddenText": "Gwall"
+            },
+            "hidden": true,
+            "description": "",
+            "pageTemplateOptions": {},
+            "screenshot": false,
+            "html": "<p class=\"govuk-error-message\">\n  <span class=\"govuk-visually-hidden\">Gwall:</span> Rhowch eich enw llawn\n</p>"
+        },
+        {
+            "name": "visually hidden text removed",
+            "options": {
+                "text": "There is an error on line 42",
+                "visuallyHiddenText": ""
+            },
+            "hidden": true,
+            "description": "",
+            "pageTemplateOptions": {},
+            "screenshot": false,
+            "html": "<p class=\"govuk-error-message\">\n  There is an error on line 42\n</p>"
+        }
+    ]
+}

data/node_modules/govuk-frontend/dist/govuk/components/error-message/macro-options.json

@@ -0,0 +1,38 @@
+[
+    {
+        "name": "text",
+        "type": "string",
+        "required": true,
+        "description": "If `html` is set, this is not required. Text to use within the error message. 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 error message. If `html` is provided, the `text` option will be ignored."
+    },
+    {
+        "name": "id",
+        "type": "string",
+        "required": false,
+        "description": "ID attribute to add to the error message `<p>` tag."
+    },
+    {
+        "name": "classes",
+        "type": "string",
+        "required": false,
+        "description": "Classes to add to the error message `<p>` tag."
+    },
+    {
+        "name": "attributes",
+        "type": "object",
+        "required": false,
+        "description": "HTML attributes (for example data attributes) to add to the error message `<p>` tag."
+    },
+    {
+        "name": "visuallyHiddenText",
+        "type": "string",
+        "required": false,
+        "description": "A visually hidden prefix used before the error message. Defaults to `\"Error\"`."
+    }
+]

data/node_modules/govuk-frontend/dist/govuk/components/error-message/macro.njk

@@ -0,0 +1,3 @@
+{% macro govukErrorMessage(params) %}
+  {%- include "./template.njk" -%}
+{% endmacro %}

data/node_modules/govuk-frontend/dist/govuk/components/error-message/template-default.html

@@ -0,0 +1,3 @@
+<p class="govuk-error-message">
+  <span class="govuk-visually-hidden">Error:</span> Error message about full name goes here
+</p>

data/node_modules/govuk-frontend/dist/govuk/components/error-message/template-translated.html

@@ -0,0 +1,3 @@
+<p class="govuk-error-message">
+  <span class="govuk-visually-hidden">Gwall:</span> Neges gwall am yr enw llawn yn mynd yma
+</p>

data/node_modules/govuk-frontend/dist/govuk/components/error-message/template.njk

@@ -0,0 +1,13 @@
+{% from "../../macros/attributes.njk" import govukAttributes -%}
+
+{% set visuallyHiddenText = params.visuallyHiddenText | default("Error") -%}
+{% set errorMessageText = params.html | safe | trim | indent(2) if params.html else params.text -%}
+
+<p {%- if params.id %} id="{{ params.id }}"{% endif %} class="govuk-error-message {%- if params.classes %} {{ params.classes }}{% endif %}"
+  {{- govukAttributes(params.attributes) }}>
+  {% if visuallyHiddenText %}
+  <span class="govuk-visually-hidden">{{ visuallyHiddenText }}:</span> {{ errorMessageText }}
+  {% else %}
+  {{ errorMessageText }}
+  {% endif %}
+</p>

data/node_modules/govuk-frontend/dist/govuk/components/error-summary/README.md

@@ -0,0 +1,15 @@
+# Error summary
+
+## Installation
+
+See the [main README quick start guide](https://github.com/alphagov/govuk-frontend#quick-start) for how to install this component.
+
+## Guidance and Examples
+
+Find out when to use the error summary component in your service in the [GOV.UK Design System](https://design-system.service.gov.uk/components/error-summary).
+
+## Component options
+
+Use options to customise the appearance, content and behaviour of a component when using a macro, for example, changing the text.
+
+See [options table](https://design-system.service.gov.uk/components/error-summary/#options-error-summary-example) for details.