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.

Link

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

Code

Markup

<a class="nhsuk-link" href="#/change">Change</a>

Macro

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

{{ link({
  text: "Change",
  href: "#/change"
}) }}
Code

Markup

<a class="nhsuk-link" href="#/change" aria-current="true">Change</a>

Macro

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

{{ link({
  text: "Change",
  href: "#/change",
  current: true
}) }}
Code

Markup

<a class="nhsuk-link" href="#/change" aria-current="page">Change</a>

Macro

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

{{ link({
  text: "Change",
  href: "#/change",
  current: "page"
}) }}
Code

Markup

<a class="nhsuk-link" href="#/change" rel="noopener noreferrer" target="_blank">Change</a>

Macro

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

{{ link({
  text: "Change",
  href: "#/change",
  openInNewTab: true
}) }}
Code

Markup

<a class="nhsuk-link" href="#/change" target="_blank" rel="noopener">Change</a>

Macro

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

{{ link({
  text: "Change",
  href: "#/change",
  openInNewTab: true,
  attributes: {
    rel: "noopener"
  }
}) }}
Code

Markup

<a class="nhsuk-link" href="#/change" target="_blank" rel="noopener">Change</a>

Macro

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

{{ link({
  text: "Change",
  href: "#/change",
  openInNewTab: true,
  attributes: {
    target: "_blank",
    rel: "noopener"
  }
}) }}
Code

Markup

<a class="nhsuk-link" href="#/change" rel="noopener noreferrer" target="_blank">Change</a>

Macro

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

{{ link({
  text: "Change",
  href: "#/change",
  openInNewTab: true,
  attributes: {
    target: "_blank"
  }
}) }}
Code

Markup

<a class="nhsuk-link nhsuk-link--reverse" href="#/change">Change</a>

Macro

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

{{ link({
  text: "Change",
  href: "#/change",
  variant: "reverse"
}) }}
Code

Markup

<a class="nhsuk-link" href="#/privacy-policy" aria-label="Read more about our privacy policy">Read more</a>

Macro

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

{{ link({
  text: "Read more",
  href: "#/privacy-policy",
  ariaLabel: "Read more about our privacy policy"
}) }}
Code

Markup

<samp class="app-annotate">Before</samp>
<a class="nhsuk-link" href="#/waiting-times"><samp class="app-annotate app-annotate--start">Start</samp>A&amp;E waiting times<samp class="app-annotate app-annotate--end">End</samp></a>
<samp class="app-annotate">After</samp>

Macro

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

{{ link({
  text: "A&E waiting times",
  href: "#/waiting-times",
  slots: {
    before: {
      html: '<samp class="app-annotate">Before</samp>'
    },
    start: {
      html: '<samp class="app-annotate app-annotate--start">Start</samp>'
    },
    end: {
      html: '<samp class="app-annotate app-annotate--end">End</samp>'
    },
    after: {
      html: '<samp class="app-annotate">After</samp>'
    }
  }
}) }}
Code

Markup

<a class="app-link" href="#/change">Change</a>

Macro

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

{{ link({
  text: "Change",
  href: "#/change",
  className: "app-link"
}) }}
Code

Markup

<a class="nhsuk-link" href="#/waiting-times">A&amp;E waiting times</a>

Macro

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

{{ link({
  html: "A&amp;E waiting times",
  href: "#/waiting-times"
}) }}
Code

Markup

<a class="nhsuk-link" href="#/waiting-times">A&amp;E waiting times</a>

Macro

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

{% call link({
  href: "#/waiting-times"
}) -%}
A&amp;E waiting times
{%- endcall %}
Code

Markup

<a href="#/change">Change</a>

Macro

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

{{ link({
  text: "Change",
  href: "#/change",
  className: false
}) }}
Code

Markup

<a class="nhsuk-link nhsuk-link--reverse" href="#/change">Change</a>

Macro

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

{{ link({
  text: "Change",
  href: "#/change",
  classes: "nhsuk-link--reverse"
}) }}
Code

Markup

<a class="nhsuk-link nhsuk-link--reverse" href="#/change">Change</a>

Macro

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

{{ link({
  text: "Change",
  href: "#/change",
  classes: "nhsuk-link--reverse",
  variant: "reverse"
}) }}
Code

Markup

<a class="nhsuk-link" href="#/waiting-times">A&amp;E waiting times</a>

Macro

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

{{ link({
  text: "A&E waiting times",
  href: "#/waiting-times"
}) }}
Code

Markup

<a class="nhsuk-link" href="#/change">Change<span class="nhsuk-u-visually-hidden"> date of birth, (Karen Francis)</span></a>

Macro

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

{{ link({
  text: "Change",
  href: "#/change",
  visuallyHidden: ["date of birth", "(Karen Francis)"]
}) }}
Code

Markup

<a class="nhsuk-link" href="#/visit">Visit<span class="nhsuk-u-visually-hidden"> A&amp;E</span></a>

Macro

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

{{ link({
  text: "Visit",
  href: "#/visit",
  visuallyHidden: {
    html: "A&amp;E",
    slots: {
      start: " "
    }
  }
}) }}
Code

Markup

<a class="nhsuk-link" href="#/change">Change<span class="nhsuk-u-visually-hidden"> date of birth</span></a>

Macro

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

{{ link({
  text: "Change",
  href: "#/change",
  visuallyHidden: "date of birth"
}) }}
Code

Markup

<a class="nhsuk-link" href="#/change">Change<span class="nhsuk-u-visually-hidden"> date of birth</span></a>

Macro

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

{{ link({
  text: "Change",
  href: "#/change",
  visuallyHiddenText: "date of birth"
}) }}
Code

Markup

<a class="nhsuk-link" href="#/date-of-birth">Enter your date of birth<span class="nhsuk-u-visually-hidden"> (Karen Francis)</span></a>

Macro

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

{{ link({
  text: "Enter your date of birth",
  href: "#/date-of-birth",
  visuallyHidden: {
    text: "(Karen Francis)",
    placement: "end",
    slots: {
      start: " "
    }
  }
}) }}
Code

Markup

<a class="nhsuk-link" href="#/visit">Visit<span class="nhsuk-u-visually-hidden"> A&amp;E</span></a>

Macro

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

{{ link({
  text: "Visit",
  href: "#/visit",
  visuallyHidden: {
    text: "A&E",
    slots: {
      start: " "
    }
  }
}) }}
Code

Markup

<a class="nhsuk-link" href="#/date-of-birth"><span class="nhsuk-u-visually-hidden">Error: </span>Enter your date of birth</a>

Macro

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

{{ link({
  text: "Enter your date of birth",
  href: "#/date-of-birth",
  visuallyHidden: {
    text: "Error:",
    placement: "start",
    slots: {
      end: " "
    }
  }
}) }}
Code

Markup

<button class="nhsuk-link" type="submit">Change</button>

Macro

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

{{ link({
  text: "Change",
  type: "submit"
}) }}