Lily Design System™

Back Link

A back link is a navigational component that allows users to return to a previous page or step within an application. It renders as a semantic anchor (<a>) element with optional aria-label for enhanced screen reader context.

Back links are especially important in mobile and multi-step interfaces, helping users maintain their sense of orientation and providing a clear, intuitive way to reverse navigation without relying solely on the browser's back button. Consumers add visual indicators (left arrow, chevron) via CSS or children content.

Example

Back
Show demo markup 
<a class="back-link" href="#">Back</a>
Usage example 
<script lang="ts">
  import BackLink from './BackLink.svelte';
</script>

<BackLink href="/previous-page">Back to previous page</BackLink>
Show Svelte source 
// In your Svelte component:
import BackLink from "lily-design-system-svelte-headless/components/BackLink/BackLink.svelte";

<BackLink>BackLink</BackLink>

Usage

<BackLink href="/registration/step-2">Back</BackLink>

<BackLink href="/application/personal-details" label="Back to personal details">
  Back
</BackLink>

Props

  • href: string (required) -- the URL to navigate back to
  • label: string (optional, default: undefined) -- accessible label override via aria-label
  • children: slot (required) -- the link text/content
  • ...restProps: Any additional HTML attributes spread onto the <a>

Keyboard Interactions

  • Tab: Focus the link
  • Enter: Activate the link (browser default)

ARIA

  • Implicit link role from the <a> element
  • aria-label -- optional override for descriptive screen reader text, set from the label prop

When to Use

  • Use on question pages and transactional service pages to help users navigate back to the previous step.
  • Use in multi-page forms where users may need to review or change earlier answers.
  • Use when the user's journey is linear and going back makes contextual sense.

When Not to Use

  • Do not use on content pages such as health information articles -- there is no transaction to go back in.
  • Do not use alongside BreadcrumbNav -- choose one navigation pattern, not both.
  • Do not use when the previous page is not meaningful in context -- consider BreadcrumbNav for hierarchical navigation instead.
  • Do not use for general "return to homepage" actions -- use a standard link or BreadcrumbNav.

Headless

This component provides a semantic <a> element with optional aria-label override and zero visual styling. The consumer is responsible for all CSS including left-arrow or chevron icons, link color, underline style, hover effects, and focus indicators.

Styles

The consumer provides all CSS styling. The component renders with a .back-link class for targeting. No default styles are included — this is a fully headless component.

Testing

  • Verify the component renders a <a> element with class back-link
  • Verify aria-label -- optional override for descriptive screen reader text, set from the label` prop
  • Verify keyboard interactions work correctly
  • Verify pass-through attributes are applied

Advice

  • Designers: Place the back link consistently at the top-left of the content area. Include a left-pointing arrow icon to visually reinforce the "back" direction.
  • Developers: Use the label prop to provide descriptive screen reader text when the visible text is short (e.g., "Back" visible but "Return to dashboard" announced).

Implementation Notes

  • Renders as a semantic <a> element for backward navigation
  • Same HTML pattern as a standard link but semantically represents "going back"
  • Supports an optional aria-label override for more descriptive screen reader text
  • All link text is provided through the children slot
  • Spreads ...restProps onto the <a> element

Related components

  • go-to-top — a link that returns users to the top of a long page
  • skip-link — a hidden link for keyboard users to skip to main content
  • breadcrumb-nav — a navigation container for breadcrumb trail links
  • action-link — a hyperlink styled as an action trigger

References

Canonical contract

Generated from this component's canonical metadata — the machine-checked source the implementations are held to.

Metadata

  • Component: back-link
  • PascalCase: BackLink
  • Description: a navigation link to return to a previous page
  • Status: stable — exercised in composed page flows under e2e and axe, beyond the per-component checks
  • HTML tag: <a>
  • CSS class: .back-link
  • Interactive: yes

ARIA

  • Implicit link role from the <a> element
  • aria-label -- optional override for descriptive screen reader text, set from the label prop

Keyboard

  • Tab: Focus the link
  • Enter: Activate the link (browser default)

Props

  • href: string (required) -- the URL to navigate back to
  • label: string (optional, default: undefined) -- accessible label override via aria-label
  • children: slot (required) -- the link text/content
  • ...restProps: Any additional HTML attributes spread onto the <a>