Resonance Logo

Link

A link navigates the user to another page, section, or resource, and should always have descriptive text that makes sense out of context.

Demo

Tab through the link examples below and observe how each one is announced by assistive technology. Notice the visible focus styling, the link text that describes the destination, and how links that open in a new tab communicate that behavior. Compare links to buttons — both are interactive, but links represent destinations while buttons trigger actions.

What to Observe

Anatomy

[Anatomy image placeholder — will be added when assets are available]

  1. Anchor element — The native <a> element with an href attribute that defines the destination; provides keyboard operability and the "link" role by default.
  2. Link text — The visible label inside the anchor that describes where the link leads; forms the accessible name when no other override is present.
  3. Icon (optional) — A decorative or informational icon accompanying the link text; must be hidden from assistive technology if the text alone is sufficient.
  4. New-tab indicator (optional) — Visible or visually hidden text (for example, "opens in a new tab") appended when the link opens in a new context.
  5. External indicator (optional) — A visual signal, such as an external link icon, indicating the link leads to a different domain.

Accessibility Behavior

Common Mistakes

Why This Matters

Links are the most fundamental navigation mechanism on the web — they are how users move between pages, jump to sections, and access resources. Screen reader users frequently navigate by pulling up a list of all links on a page, which means a page full of "click here" or "read more" links becomes a list of identical, meaningless entries. Users who cannot distinguish links from body text visually may activate them accidentally or miss them entirely. Getting link semantics and text right is one of the highest-return accessibility investments because it affects every page of a product, every time a user navigates.

Accessibility Validation

This component is validated against internal accessibility criteria aligned with WCAG standards, using our internally developed system, Resonance Specs.

To learn more, please contact us.

Code

Reference Implementation