govuk_tech_docs 6.6.0.rc.local.tested → 6.6.0

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

@@ -0,0 +1,119 @@
+[
+    {
+        "name": "items",
+        "type": "array",
+        "required": true,
+        "description": "The items for each task within the task list component.",
+        "params": [
+            {
+                "name": "title",
+                "type": "object",
+                "required": true,
+                "description": "The main title for the task within the task list component.",
+                "params": [
+                    {
+                        "name": "text",
+                        "type": "string",
+                        "required": true,
+                        "description": "Text to use within the title. If `html` is provided, the `text` argument will be ignored."
+                    },
+                    {
+                        "name": "html",
+                        "type": "string",
+                        "required": true,
+                        "description": "HTML to use within the title. If `html` is provided, the `text` argument will be ignored."
+                    },
+                    {
+                        "name": "classes",
+                        "type": "string",
+                        "required": false,
+                        "description": "Classes to add to the title wrapper."
+                    }
+                ]
+            },
+            {
+                "name": "hint",
+                "type": "object",
+                "required": false,
+                "description": "Can be used to add a hint to each task within the task list component.",
+                "params": [
+                    {
+                        "name": "text",
+                        "type": "string",
+                        "required": true,
+                        "description": "Text to use within the hint. If `html` is provided, the `text` argument will be ignored."
+                    },
+                    {
+                        "name": "html",
+                        "type": "string",
+                        "required": true,
+                        "description": "HTML to use within the hint. If `html` is provided, the `text` argument will be ignored."
+                    }
+                ]
+            },
+            {
+                "name": "status",
+                "type": "object",
+                "required": true,
+                "description": "The status for each task within the task list component.",
+                "params": [
+                    {
+                        "name": "tag",
+                        "type": "object",
+                        "isComponent": true,
+                        "required": false,
+                        "description": "Can be used to add a tag to the status of the task within the task list component."
+                    },
+                    {
+                        "name": "text",
+                        "required": false,
+                        "type": "string",
+                        "description": "Text to use for the status, as an alternative to using a tag. If `html` or `tag` is provided, the `text` argument will be ignored."
+                    },
+                    {
+                        "name": "html",
+                        "required": false,
+                        "type": "string",
+                        "description": "HTML to use for the status, as an alternative to using a tag. If `html` or `tag` is provided, the `text` argument will be ignored."
+                    },
+                    {
+                        "name": "classes",
+                        "type": "string",
+                        "required": false,
+                        "description": "Classes to add to the status container."
+                    }
+                ]
+            },
+            {
+                "name": "href",
+                "type": "string",
+                "required": false,
+                "description": "The value of the link’s `href` attribute for the task list item."
+            },
+            {
+                "name": "classes",
+                "type": "string",
+                "required": false,
+                "description": "Classes to add to the item `div`."
+            }
+        ]
+    },
+    {
+        "name": "classes",
+        "type": "string",
+        "required": false,
+        "description": "Classes to add to the `ul` container for the task list."
+    },
+    {
+        "name": "attributes",
+        "type": "object",
+        "required": false,
+        "description": "HTML attributes (for example data attributes) to add to the `ul` container for the task list."
+    },
+    {
+        "name": "idPrefix",
+        "type": "string",
+        "required": false,
+        "description": "Optional prefix. This is used to prefix the `id` attribute for the task list item tag and hint, separated by `-`. Defaults to `\"task-list\"`."
+    }
+]

data/node_modules/govuk-frontend/dist/govuk/components/task-list/macro.njk

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

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

@@ -0,0 +1,37 @@
+
+<ul class="govuk-task-list">
+  <li class="govuk-task-list__item govuk-task-list__item--with-link">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-1-status">
+        Company Directors
+      </a>
+    </div>
+    <div class="govuk-task-list__status" id="task-list-1-status">
+      Completed
+    </div>
+  </li>
+  <li class="govuk-task-list__item govuk-task-list__item--with-link">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-2-status">
+        Registered company details
+      </a>
+    </div>
+    <div class="govuk-task-list__status" id="task-list-2-status">
+      <strong class="govuk-tag govuk-tag--blue">
+        Incomplete
+      </strong>
+    </div>
+  </li>
+  <li class="govuk-task-list__item govuk-task-list__item--with-link">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-3-status">
+        Business plan
+      </a>
+    </div>
+    <div class="govuk-task-list__status" id="task-list-3-status">
+      <strong class="govuk-tag govuk-tag--blue">
+        Incomplete
+      </strong>
+    </div>
+  </li>
+</ul>

data/node_modules/govuk-frontend/dist/govuk/components/task-list/template-forced-hover-state.html

@@ -0,0 +1,37 @@
+
+<ul class="govuk-task-list">
+  <li class="govuk-task-list__item govuk-task-list__item--with-link :hover">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-1-status">
+        Company Directors
+      </a>
+    </div>
+    <div class="govuk-task-list__status" id="task-list-1-status">
+      Completed
+    </div>
+  </li>
+  <li class="govuk-task-list__item govuk-task-list__item--with-link">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-2-status">
+        Registered company details
+      </a>
+    </div>
+    <div class="govuk-task-list__status" id="task-list-2-status">
+      <strong class="govuk-tag govuk-tag--blue">
+        Incomplete
+      </strong>
+    </div>
+  </li>
+  <li class="govuk-task-list__item govuk-task-list__item--with-link">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-3-status">
+        Business plan
+      </a>
+    </div>
+    <div class="govuk-task-list__status" id="task-list-3-status">
+      <strong class="govuk-tag govuk-tag--blue">
+        Incomplete
+      </strong>
+    </div>
+  </li>
+</ul>

data/node_modules/govuk-frontend/dist/govuk/components/task-list/template-with-all-possible-colours.html

@@ -0,0 +1,131 @@
+
+<ul class="govuk-task-list">
+  <li class="govuk-task-list__item govuk-task-list__item--with-link">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-1-status">
+        Task A
+      </a>
+    </div>
+    <div class="govuk-task-list__status" id="task-list-1-status">
+      Text colour
+    </div>
+  </li>
+  <li class="govuk-task-list__item govuk-task-list__item--with-link">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-2-status">
+        Task B
+      </a>
+    </div>
+    <div class="govuk-task-list__status govuk-task-list__status--cannot-start-yet" id="task-list-2-status">
+      Secondary text colour
+    </div>
+  </li>
+  <li class="govuk-task-list__item govuk-task-list__item--with-link">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-3-status">
+        Task C
+      </a>
+    </div>
+    <div class="govuk-task-list__status" id="task-list-3-status">
+      <strong class="govuk-tag govuk-tag--grey">
+        Grey
+      </strong>
+    </div>
+  </li>
+  <li class="govuk-task-list__item govuk-task-list__item--with-link">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-4-status">
+        Task D
+      </a>
+    </div>
+    <div class="govuk-task-list__status" id="task-list-4-status">
+      <strong class="govuk-tag govuk-tag--blue">
+        Blue
+      </strong>
+    </div>
+  </li>
+  <li class="govuk-task-list__item govuk-task-list__item--with-link">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-5-status">
+        Task E
+      </a>
+    </div>
+    <div class="govuk-task-list__status" id="task-list-5-status">
+      <strong class="govuk-tag govuk-tag--teal">
+        Teal
+      </strong>
+    </div>
+  </li>
+  <li class="govuk-task-list__item govuk-task-list__item--with-link">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-6-status">
+        Task F
+      </a>
+    </div>
+    <div class="govuk-task-list__status" id="task-list-6-status">
+      <strong class="govuk-tag govuk-tag--green">
+        Green
+      </strong>
+    </div>
+  </li>
+  <li class="govuk-task-list__item govuk-task-list__item--with-link">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-7-status">
+        Task G
+      </a>
+    </div>
+    <div class="govuk-task-list__status" id="task-list-7-status">
+      <strong class="govuk-tag govuk-tag--purple">
+        Purple
+      </strong>
+    </div>
+  </li>
+  <li class="govuk-task-list__item govuk-task-list__item--with-link">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-8-status">
+        Task H
+      </a>
+    </div>
+    <div class="govuk-task-list__status" id="task-list-8-status">
+      <strong class="govuk-tag govuk-tag--magenta">
+        Magenta
+      </strong>
+    </div>
+  </li>
+  <li class="govuk-task-list__item govuk-task-list__item--with-link">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-9-status">
+        Task I
+      </a>
+    </div>
+    <div class="govuk-task-list__status" id="task-list-9-status">
+      <strong class="govuk-tag govuk-tag--red">
+        Red
+      </strong>
+    </div>
+  </li>
+  <li class="govuk-task-list__item govuk-task-list__item--with-link">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-10-status">
+        Task J
+      </a>
+    </div>
+    <div class="govuk-task-list__status" id="task-list-10-status">
+      <strong class="govuk-tag govuk-tag--orange">
+        Orange
+      </strong>
+    </div>
+  </li>
+  <li class="govuk-task-list__item govuk-task-list__item--with-link">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-11-status">
+        Task K
+      </a>
+    </div>
+    <div class="govuk-task-list__status" id="task-list-11-status">
+      <strong class="govuk-tag govuk-tag--yellow">
+        Yellow
+      </strong>
+    </div>
+  </li>
+</ul>

data/node_modules/govuk-frontend/dist/govuk/components/task-list/template-with-empty-values.html

@@ -0,0 +1,27 @@
+
+<ul class="govuk-task-list">
+
+
+  <li class="govuk-task-list__item govuk-task-list__item--with-link">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-3-status">
+        Task A
+      </a>
+    </div>
+    <div class="govuk-task-list__status" id="task-list-3-status">
+      Completed
+    </div>
+  </li>
+
+
+  <li class="govuk-task-list__item govuk-task-list__item--with-link">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-6-status">
+        Task B
+      </a>
+    </div>
+    <div class="govuk-task-list__status" id="task-list-6-status">
+      Completed
+    </div>
+  </li>
+</ul>

data/node_modules/govuk-frontend/dist/govuk/components/task-list/template-with-hint-text-and-additional-states.html

@@ -0,0 +1,77 @@
+
+<ul class="govuk-task-list">
+  <li class="govuk-task-list__item govuk-task-list__item--with-link">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-1-status">
+        Company Directors
+      </a>
+    </div>
+    <div class="govuk-task-list__status" id="task-list-1-status">
+      Completed
+    </div>
+  </li>
+  <li class="govuk-task-list__item govuk-task-list__item--with-link">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-2-status">
+        Registered company details
+      </a>
+    </div>
+    <div class="govuk-task-list__status" id="task-list-2-status">
+      <strong class="govuk-tag govuk-tag--teal">
+        Not started
+      </strong>
+    </div>
+  </li>
+  <li class="govuk-task-list__item govuk-task-list__item--with-link">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-3-hint task-list-3-status">
+        Business plan
+      </a>
+      <div id="task-list-3-hint" class="govuk-task-list__hint">
+        Ensure the plan covers objectives, strategies, sales, marketing and financial forecasts.
+      </div>
+    </div>
+    <div class="govuk-task-list__status" id="task-list-3-status">
+      <strong class="govuk-tag govuk-tag--magenta">
+        Review
+      </strong>
+    </div>
+  </li>
+  <li class="govuk-task-list__item govuk-task-list__item--with-link">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-4-status">
+        Documentation
+      </a>
+    </div>
+    <div class="govuk-task-list__status" id="task-list-4-status">
+      <strong class="govuk-tag govuk-tag--blue">
+        In progress
+      </strong>
+    </div>
+  </li>
+  <li class="govuk-task-list__item govuk-task-list__item--with-link">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-5-status">
+        Charitable status
+      </a>
+    </div>
+    <div class="govuk-task-list__status" id="task-list-5-status">
+      <strong class="govuk-tag govuk-tag--red">
+        Error
+      </strong>
+    </div>
+  </li>
+  <li class="govuk-task-list__item">
+    <div class="govuk-task-list__name-and-hint">
+      <div>
+        Payment
+      </div>
+      <div id="task-list-6-hint" class="govuk-task-list__hint">
+        It will cost between £15 and £75
+      </div>
+    </div>
+    <div class="govuk-task-list__status govuk-task-list__status--cannot-start-yet" id="task-list-6-status">
+      Cannot start yet
+    </div>
+  </li>
+</ul>

data/node_modules/govuk-frontend/dist/govuk/components/task-list/template-with-very-long-single-word-tags.html

@@ -0,0 +1,37 @@
+
+<ul class="govuk-task-list">
+  <li class="govuk-task-list__item govuk-task-list__item--with-link">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-1-status">
+        Company Directors
+      </a>
+    </div>
+    <div class="govuk-task-list__status" id="task-list-1-status">
+      Completed
+    </div>
+  </li>
+  <li class="govuk-task-list__item govuk-task-list__item--with-link">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-2-status">
+        Registered company details
+      </a>
+    </div>
+    <div class="govuk-task-list__status" id="task-list-2-status">
+      <strong class="govuk-tag govuk-tag--blue">
+        Incomplete
+      </strong>
+    </div>
+  </li>
+  <li class="govuk-task-list__item govuk-task-list__item--with-link">
+    <div class="govuk-task-list__name-and-hint">
+      <a class="govuk-link govuk-task-list__link" href="#" aria-describedby="task-list-3-status">
+        A very very very long Business plan
+      </a>
+    </div>
+    <div class="govuk-task-list__status" id="task-list-3-status">
+      <strong class="govuk-tag govuk-tag--blue">
+        Thisisaverylongwaytosaythatsomethingisincomplete
+      </strong>
+    </div>
+  </li>
+</ul>

data/node_modules/govuk-frontend/dist/govuk/components/task-list/template.njk

@@ -0,0 +1,41 @@
+{% from "../../macros/attributes.njk" import govukAttributes %}
+{% from "../tag/macro.njk" import govukTag %}
+
+{%- set idPrefix = params.idPrefix if params.idPrefix else "task-list" -%}
+
+{%- macro _taskListItem(params, item, index) %}
+  {%- set hintId = idPrefix + "-" + index + "-hint" %}
+  {%- set statusId = idPrefix + "-" + index + "-status" %}
+  <li class="govuk-task-list__item {%- if item.href %} govuk-task-list__item--with-link{% endif %}{%- if item.classes %} {{ item.classes }}{% endif %}">
+    <div class="govuk-task-list__name-and-hint">
+    {% if item.href %}
+      <a class="govuk-link govuk-task-list__link {%- if item.title.classes %} {{ item.title.classes }}{% endif %}" href="{{ item.href }}" aria-describedby="{{ hintId + " " if item.hint }}{{ statusId }}">
+        {{ item.title.html | safe | trim | indent(8) if item.title.html else item.title.text }}
+      </a>
+    {% else %}
+      <div {%- if item.title.classes %} class="{{ item.title.classes }}"{% endif %}>
+        {{ item.title.html | safe | trim | indent(8) if item.title.html else item.title.text }}
+      </div>
+    {% endif %}
+    {% if item.hint %}
+      <div id="{{ hintId }}" class="govuk-task-list__hint">
+        {{ item.hint.html | safe | trim | indent(8) if item.hint.html else item.hint.text }}
+      </div>
+    {% endif %}
+    </div>
+    <div class="govuk-task-list__status {%- if item.status.classes %} {{ item.status.classes }}{% endif %}" id="{{ statusId }}">
+    {% if item.status.tag %}
+      {{ govukTag(item.status.tag) | trim | indent(6) }}
+    {% else %}
+      {{ item.status.html | safe | trim | indent(6) if item.status.html else item.status.text }}
+    {% endif %}
+    </div>
+  </li>
+{%- endmacro %}
+
+<ul class="govuk-task-list {%- if params.classes %} {{ params.classes }}{% endif %}"
+  {{- govukAttributes(params.attributes) }}>
+  {% for item in params.items %}
+    {{- _taskListItem(params, item, loop.index) if item }}
+  {% endfor %}
+</ul>

data/node_modules/govuk-frontend/dist/govuk/components/textarea/README.md

@@ -0,0 +1,15 @@
+# Textarea
+
+## 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 textarea component in your service in the [GOV.UK Design System](https://design-system.service.gov.uk/components/textarea).
+
+## 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/textarea/#options-textarea-example) for details.