Read the Check your application status before you apply.
Inline
Inside a sentence. It wraps onto the next line with the text.
Links take people to another page, a place on the same page or another site. They sit inside a sentence or on their own, and keep their underline in every state.
Updated
Link
Usage
<a href="/applications/status" class="nds-link">Check your application status</a> Add the NDS Link block, or paste this markup into the Code editor
<!-- wp:nds/link {"size":"md"} --><a href="/applications/status" class="nds-link">Check your application status</a><!-- /wp:nds/link --> Usage
// Import the componentimport { Link } from "@nigerian-design-standards/react";// Use it<Link href="/applications/status" size="md"> Check your application status</Link> Usage
// Import the componentuse NDS\Components\Link;// Use itecho Link::render([ 'href' => '/applications/status', 'size' => 'md', 'label' => 'Check your application status',]); A link takes people somewhere: to another page, to a place on the same page, or to another site. If the control does something on the page, use a button.
Two ways to use the same component, not separate variants or states. Both keep the underline, so they can be found without colour.
Read the Check your application status before you apply.
Inside a sentence. It wraps onto the next line with the text.
On its own: back links, resource lists and card footers. No icons.
The properties the nds-link component has. The same in HTML, WordPress and React.
| Property | Type | Possible values | Description |
|---|---|---|---|
| size | string |
| Text size: 12/16, 14/20 or 16/20. Match the text around the link. |
| state | string |
| For design and QA. In code they come from :hover, :focus-visible, :active and :visited. |
| underline | fixed | always on | Always on, in every state and size, 3px below the text. People find links by the underline, not the colour. |
In code, write a real <a href="…">. For a link that opens a new tab, say so in the
link text and add rel="noopener noreferrer".
| State | Token | Contrast on the page |
|---|---|---|
| Default | status/info/surface | 5.6:1 |
| Hover | status/info/hover | 7.5:1 |
| Focused | status/info/hover, with a border/focus ring | 7.5:1 · ring 4.5:1 |
| Pressed | status/info/pressed | 9.8:1 |
| Visited | text/muted | 6.6:1 |
Link text says where it goes, so it makes sense on its own.
“Click here” doesn’t say where it goes. Screen reader users often hear links as a list, out of context.
Where links sit and how much room they need.
Inline links wrap onto the next line with the sentence. Don’t force them onto one line.
Give them 24px of height: add 4px above and below for Md and Lg, 8px for Sm.
Md is the default. Md next to 14px text, Lg next to 16px (proposed).
A link is text and an underline. When an action needs an icon, use a tertiary button.
Don’t put two links next to each other with no space. Leave space or a separator.
How to write link text. Clear words help everyone, especially people using screen readers, who often hear links as a list.
Use the name of the page or the thing people will get.
The link text alone should say where it goes, without the sentence around it.
Or “read more” and “learn more”. If the design needs short text, add hidden context for screen readers: “Learn more about fees”.
Write the name of the page, not www.example.gov.ng.
Add “(opens in a new tab)” to the link text.
Capitalise only the first word and names.
| Write | Don’t write | Why |
|---|---|---|
| Apply for a driver’s licence | Click here | Says where the link goes. |
| Fees for registration | Read more | Makes sense when read out of context. |
| Visit the CAC website (opens in a new tab) | www.cac.gov.ng | Names the site and warns about the new tab. |
| Guidance on choosing a name | Learn more | Names the page people will land on. |
Built on a real <a href> element, so it works with keyboards, screen readers and browser features like open in new tab.
| Key | What it does |
|---|---|
| Enter | Follows the link. |
| Space | Does nothing. Space belongs to buttons and scrolls the page. |
| Tab | Moves focus to the next link or control. |
Copy the code for HTML, WordPress or React from the Code tab in Live example. The options are listed under Specifications.
Use the nds-link component from 01 Library – Foundations. Don’t detach it.
Is this page useful?