Skip to main content
Preview This is a design system preview environment for main branch

Internal review app NHS.UK frontend

Use design system guidance and examples to build consistent, accessible NHS services for the public and staff.

Textarea

These examples are used for automated tests and may not follow service manual best practice.

Do not include personal information like your name, date of birth or NHS number
Code

Markup

<div class="nhsuk-form-group">
  <h1 class="nhsuk-label-wrapper">
    <label class="nhsuk-label nhsuk-label--l" for="example">
      Can you provide more detail?
    </label>
  </h1>
  <div class="nhsuk-hint" id="example-hint">
    Do not include personal information like your name, date of birth or NHS number
  </div>
  <textarea class="nhsuk-textarea" id="example" name="example" rows="5" aria-describedby="example-hint"></textarea>
</div>

Macro

{% from "textarea/macro.njk" import textarea -%}

{{ textarea({
  label: {
    heading: "Can you provide more detail?",
    size: "l"
  },
  hint: {
    text: "Do not include personal information like your name, date of birth or NHS number"
  },
  name: "example"
}) }}

Do not include personal information like your name, date of birth or NHS number
Code

Markup

<div class="nhsuk-form-group">
  <h1 class="nhsuk-label-wrapper">
    <label class="nhsuk-label nhsuk-label--l" for="example">
      Can you provide more detail?
    </label>
  </h1>
  <div class="nhsuk-hint" id="example-hint">
    Do not include personal information like your name, date of birth or NHS number
  </div>
  <textarea class="nhsuk-textarea" id="example" name="example" rows="5" disabled aria-describedby="example-hint"></textarea>
</div>

Macro

{% from "textarea/macro.njk" import textarea -%}

{{ textarea({
  label: {
    heading: "Can you provide more detail?",
    size: "l"
  },
  hint: {
    text: "Do not include personal information like your name, date of birth or NHS number"
  },
  name: "example",
  disabled: true
}) }}

Do not include personal information like your name, date of birth or NHS number
Code

Markup

<div class="nhsuk-form-group">
  <h1 class="nhsuk-label-wrapper">
    <label class="nhsuk-label nhsuk-label--s" for="custom-size">
      Can you provide more detail?
    </label>
  </h1>
  <div class="nhsuk-hint" id="custom-size-hint">
    Do not include personal information like your name, date of birth or NHS number
  </div>
  <textarea class="nhsuk-textarea" id="custom-size" name="example" rows="5" aria-describedby="custom-size-hint"></textarea>
</div>

Macro

{% from "textarea/macro.njk" import textarea -%}

{{ textarea({
  label: {
    heading: "Can you provide more detail?",
    size: "s"
  },
  hint: {
    text: "Do not include personal information like your name, date of birth or NHS number"
  },
  id: "custom-size",
  name: "example"
}) }}

Do not include personal information like your name, date of birth or NHS number
Code

Markup

<div class="nhsuk-form-group">
  <h1 class="nhsuk-label-wrapper">
    <label class="nhsuk-label nhsuk-label--m" for="custom-size">
      Can you provide more detail?
    </label>
  </h1>
  <div class="nhsuk-hint" id="custom-size-hint">
    Do not include personal information like your name, date of birth or NHS number
  </div>
  <textarea class="nhsuk-textarea" id="custom-size" name="example" rows="5" aria-describedby="custom-size-hint"></textarea>
</div>

Macro

{% from "textarea/macro.njk" import textarea -%}

{{ textarea({
  label: {
    heading: "Can you provide more detail?",
    size: "m"
  },
  hint: {
    text: "Do not include personal information like your name, date of birth or NHS number"
  },
  id: "custom-size",
  name: "example"
}) }}

Do not include personal information like your name, date of birth or NHS number
Code

Markup

<div class="nhsuk-form-group">
  <h1 class="nhsuk-label-wrapper">
    <label class="nhsuk-label nhsuk-label--l" for="custom-size">
      Can you provide more detail?
    </label>
  </h1>
  <div class="nhsuk-hint" id="custom-size-hint">
    Do not include personal information like your name, date of birth or NHS number
  </div>
  <textarea class="nhsuk-textarea" id="custom-size" name="example" rows="5" aria-describedby="custom-size-hint"></textarea>
</div>

Macro

{% from "textarea/macro.njk" import textarea -%}

{{ textarea({
  label: {
    heading: "Can you provide more detail?",
    size: "l"
  },
  hint: {
    text: "Do not include personal information like your name, date of birth or NHS number"
  },
  id: "custom-size",
  name: "example"
}) }}

Do not include personal information like your name, date of birth or NHS number
Code

Markup

<div class="nhsuk-form-group">
  <h1 class="nhsuk-label-wrapper">
    <label class="nhsuk-label nhsuk-label--xl" for="custom-size">
      Can you provide more detail?
    </label>
  </h1>
  <div class="nhsuk-hint" id="custom-size-hint">
    Do not include personal information like your name, date of birth or NHS number
  </div>
  <textarea class="nhsuk-textarea" id="custom-size" name="example" rows="5" aria-describedby="custom-size-hint"></textarea>
</div>

Macro

{% from "textarea/macro.njk" import textarea -%}

{{ textarea({
  label: {
    heading: "Can you provide more detail?",
    size: "xl"
  },
  hint: {
    text: "Do not include personal information like your name, date of birth or NHS number"
  },
  id: "custom-size",
  name: "example"
}) }}

Code

Markup

<div class="nhsuk-form-group">
  <h1 class="nhsuk-label-wrapper">
    <label class="nhsuk-label nhsuk-label--l" for="with-autocomplete-attribute">
      Full address
    </label>
  </h1>
  <textarea class="nhsuk-textarea" id="with-autocomplete-attribute" name="example" rows="5" autocomplete="street-address"></textarea>
</div>

Macro

{% from "textarea/macro.njk" import textarea -%}

{{ textarea({
  label: {
    heading: "Full address",
    size: "l"
  },
  id: "with-autocomplete-attribute",
  name: "example",
  autocomplete: "street-address"
}) }}

Do not include personal information like your name, date of birth or NHS number
Before After
Code

Markup

<div class="nhsuk-form-group">
  <h1 class="nhsuk-label-wrapper">
    <label class="nhsuk-label nhsuk-label--l" for="example">
      Can you provide more detail?
    </label>
  </h1>
  <div class="nhsuk-hint" id="example-hint">
    Do not include personal information like your name, date of birth or NHS number
  </div>
  <samp class="app-annotate">Before</samp>
  <textarea class="nhsuk-textarea" id="example" name="example" rows="5" aria-describedby="example-hint"></textarea>
  <samp class="app-annotate">After</samp>
</div>

Macro

{% from "textarea/macro.njk" import textarea -%}

{{ textarea({
  label: {
    heading: "Can you provide more detail?",
    size: "l"
  },
  hint: {
    text: "Do not include personal information like your name, date of birth or NHS number"
  },
  name: "example",
  formGroup: {
    beforeInput: {
      html: '<samp class="app-annotate">Before</samp>'
    },
    afterInput: {
      html: '<samp class="app-annotate">After</samp>'
    }
  }
}) }}

Error: You must provide an explanation

Code

Markup

<div class="nhsuk-form-group nhsuk-form-group--error">
  <h1 class="nhsuk-label-wrapper">
    <label class="nhsuk-label nhsuk-label--l" for="with-error-message">
      Can you provide more detail?
    </label>
  </h1>
  <p class="nhsuk-error-message" id="with-error-message-error">
    <span class="nhsuk-u-visually-hidden">Error: </span>You must provide an explanation
  </p>
  <textarea class="nhsuk-textarea nhsuk-textarea--error" id="with-error-message" name="example" rows="5" aria-describedby="with-error-message-error"></textarea>
</div>

Macro

{% from "textarea/macro.njk" import textarea -%}

{{ textarea({
  label: {
    heading: "Can you provide more detail?",
    size: "l"
  },
  errorMessage: {
    text: "You must provide an explanation"
  },
  id: "with-error-message",
  name: "example"
}) }}

Do not include personal information like your name, date of birth or NHS number

Error: You must provide an explanation

Code

Markup

<div class="nhsuk-form-group nhsuk-form-group--error">
  <h1 class="nhsuk-label-wrapper">
    <label class="nhsuk-label nhsuk-label--l" for="with-hint-error">
      Can you provide more detail?
    </label>
  </h1>
  <div class="nhsuk-hint" id="with-hint-error-hint">
    Do not include personal information like your name, date of birth or NHS number
  </div>
  <p class="nhsuk-error-message" id="with-hint-error-error">
    <span class="nhsuk-u-visually-hidden">Error: </span>You must provide an explanation
  </p>
  <textarea class="nhsuk-textarea nhsuk-textarea--error" id="with-hint-error" name="example" rows="5" aria-describedby="with-hint-error-hint with-hint-error-error"></textarea>
</div>

Macro

{% from "textarea/macro.njk" import textarea -%}

{{ textarea({
  label: {
    heading: "Can you provide more detail?",
    size: "l"
  },
  hint: {
    text: "Do not include personal information like your name, date of birth or NHS number"
  },
  errorMessage: {
    text: "You must provide an explanation"
  },
  id: "with-hint-error",
  name: "example"
}) }}

Do not include personal information like your name, date of birth or NHS number

Error: You must provide an explanation

Code

Markup

<div class="nhsuk-form-group nhsuk-form-group--error">
  <h1 class="nhsuk-label-wrapper">
    <label class="nhsuk-label nhsuk-label--l" for="with-hint-error">
      Can you provide more detail?
    </label>
  </h1>
  <div class="nhsuk-hint" id="with-hint-error-hint">
    Do not include personal information like your name, date of birth or NHS number
  </div>
  <p class="nhsuk-error-message" id="with-hint-error-error">
    <span class="nhsuk-u-visually-hidden">Error: </span>You must provide an explanation
  </p>
  <textarea class="nhsuk-textarea nhsuk-textarea--error" id="with-hint-error" name="example" rows="5" aria-describedby="with-hint-error-hint with-hint-error-error"></textarea>
</div>

Macro

{% from "textarea/macro.njk" import textarea -%}

{{ textarea({
  label: {
    heading: "Can you provide more detail?",
    size: "l"
  },
  hint: "Do not include personal information like your name, date of birth or NHS number",
  errorMessage: "You must provide an explanation",
  id: "with-hint-error",
  name: "example"
}) }}
Do not include personal information like your name, date of birth or NHS number

Error: You must provide an explanation

Code

Markup

<div class="nhsuk-form-group nhsuk-form-group--error">
  <label class="nhsuk-label" for="with-hint-error">
    Can you provide more detail?
  </label>
  <div class="nhsuk-hint" id="with-hint-error-hint">
    Do not include personal information like your name, date of birth or NHS number
  </div>
  <p class="nhsuk-error-message" id="with-hint-error-error">
    <span class="nhsuk-u-visually-hidden">Error: </span>You must provide an explanation
  </p>
  <textarea class="nhsuk-textarea nhsuk-textarea--error" id="with-hint-error" name="example" rows="5" aria-describedby="with-hint-error-hint with-hint-error-error"></textarea>
</div>

Macro

{% from "textarea/macro.njk" import textarea -%}

{{ textarea({
  label: {
    text: "Can you provide more detail?"
  },
  hint: {
    text: "Do not include personal information like your name, date of birth or NHS number"
  },
  errorMessage: {
    text: "You must provide an explanation"
  },
  id: "with-hint-error",
  name: "example"
}) }}

Error: You must provide an explanation

Code

Markup

<div class="nhsuk-form-group nhsuk-form-group--error">
  <label class="nhsuk-label" for="with-error-message">
    Can you provide more detail?
  </label>
  <p class="nhsuk-error-message" id="with-error-message-error">
    <span class="nhsuk-u-visually-hidden">Error: </span>You must provide an explanation
  </p>
  <textarea class="nhsuk-textarea nhsuk-textarea--error" id="with-error-message" name="example" rows="5" aria-describedby="with-error-message-error"></textarea>
</div>

Macro

{% from "textarea/macro.njk" import textarea -%}

{{ textarea({
  label: {
    text: "Can you provide more detail?"
  },
  errorMessage: {
    text: "You must provide an explanation"
  },
  id: "with-error-message",
  name: "example"
}) }}

Code

Markup

<div class="nhsuk-form-group nhsuk-form-group--error">
  <h1 class="nhsuk-label-wrapper">
    <label class="nhsuk-label nhsuk-label--l" for="with-error-only">
      Can you provide more detail?
    </label>
  </h1>
  <textarea class="nhsuk-textarea nhsuk-textarea--error" id="with-error-only" name="example" rows="5"></textarea>
</div>

Macro

{% from "textarea/macro.njk" import textarea -%}

{{ textarea({
  label: {
    heading: "Can you provide more detail?",
    size: "l"
  },
  errorMessage: true,
  id: "with-error-only",
  name: "example"
}) }}

Do not include personal information like your name, date of birth or NHS number
Code

Markup

<div class="nhsuk-form-group">
  <h1 class="nhsuk-label-wrapper">
    <label class="nhsuk-label nhsuk-label--l" for="with-hint">
      Can you provide more detail?
    </label>
  </h1>
  <div class="nhsuk-hint" id="with-hint-hint">
    Do not include personal information like your name, date of birth or NHS number
  </div>
  <textarea class="nhsuk-textarea" id="with-hint" name="example" rows="5" aria-describedby="with-hint-hint"></textarea>
</div>

Macro

{% from "textarea/macro.njk" import textarea -%}

{{ textarea({
  label: {
    heading: "Can you provide more detail?",
    size: "l"
  },
  hint: {
    text: "Do not include personal information like your name, date of birth or NHS number"
  },
  id: "with-hint",
  name: "example"
}) }}
Do not include personal information like your name, date of birth or NHS number
Code

Markup

<div class="nhsuk-form-group">
  <label class="nhsuk-label" for="without-heading">
    Can you provide more detail?
  </label>
  <div class="nhsuk-hint" id="without-heading-hint">
    Do not include personal information like your name, date of birth or NHS number
  </div>
  <textarea class="nhsuk-textarea" id="without-heading" name="example" rows="5" aria-describedby="without-heading-hint"></textarea>
</div>

Macro

{% from "textarea/macro.njk" import textarea -%}

{{ textarea({
  label: "Can you provide more detail?",
  hint: "Do not include personal information like your name, date of birth or NHS number",
  id: "without-heading",
  name: "example"
}) }}