Component · action.link

Link

A navigation affordance that moves to another location or view.

Informative mappings only. Platform examples below describe possible target primitives. This release does not ship adapters for React, Swift, Android or any other platform.

Anatomy

PartRequiredDescription
label yes Visible destination name.
icon no Optional leading or trailing icon.

States

  • default
  • hover
  • focus-visible
  • visited
  • disabled

Keyboard

  • Enter activates the link

Accessibility

Expose a link role with a destination-oriented name. Distinguish links from buttons in semantics even when styled similarly. Disabled or inert links must not remain in the tab order as activatable controls.

Motion

Underline or color transitions may ease in; under reduced motion, apply the hover and focus styles immediately.

Platform mappings

web

web

Prefer native HTML a with href; role=link only as a last resort.

apple

apple

SwiftUI Link or NavigationLink mapped to the platform navigation pattern.

android

android

Compose TextButton/Clickable Text or Material navigation affordances with proper semantics.