Jump links
On this page
Implementation
Jump links
- Provide a unique and descriptive accessible name to the jump links element
- This can be achieved using
aria-labelledby
,aria-label
, or theaccessible-label
API
- This can be achieved using
- Ensure each jump link has descriptive text that says what section a user will jump to if they select it
Responsive jump links
To make jump links responsive, they must be composed inside of a disclosure for mobile viewports.
- Provide a unique and descriptive accessible name to the disclosure if it is expandable
- If the disclosure uses an icon as its trigger, be sure to provide an accessible name for the icon
- Ensure the disclosure has an
aria-expanded
attribute that matches its expanded state- If users implement
<rh-disclosure>
or a<details>
/<summary>
element,aria-expanded
is not necessary
- If users implement
Keyboard interactions
Each individual jump link can be navigated with a keyboard. However, focus moving to a jump link does not mean it has been selected.
Key | Result |
---|---|
Tab |
|
Shift+Tab |
|
Enter |
|
Focus order
Focus moves through jump links first and then other elements from top to bottom or left to right.
Touch targets
Each individual jump link and the disclosure trigger button are large enough to be selected easily.
ARIA Authoring Practices Guide (APG)
Learn to use the accessibility semantics defined by the Accessible Rich Internet Application (ARIA) specification to create accessible web experiences.
Web Content Accessibility Guidelines
Understanding documents provide detailed explanations for Web Content Accessibility Guidelines (WCAG) guidelines and success criteria.
- SC 2.1.1 Keyboard (Level A)
- SC 2.1.3 Keyboard (no exception) (Level AAA)
- SC 2.4.3 Focus order (Level A)
- SC 2.5.5 Target size (Level AAA)
Other libraries
To learn more about our other libraries, visit this page.
Feedback
To give feedback about anything on this page, contact us.