Jump links

Jump links allow users to navigate to sections within a page.


JumpLinks has a scrollspy built-in to make your implementation easier. When implementing JumpLinks be sure to:

  1. Find the correct scrollableSelector for your page via Firefox's debugging scrollable overflow or by adding hasOverflowScroll to a PageSection or PageGroup.
    • If you add hasOverflowScroll to a Page sub-component you should also add a relevant aria-label to that component as well.
  2. Provide hrefs to your JumpLinksItems which match the id of elements you want to spy on. If you wish to scroll to a different item than you're linking to use the node prop.

Scrollspy with subsections

This demo expands on the previous to show the JumpLinks in a vertical layout with subsections. It scrolls the Page's mainContainerId with an offset calculated based on the height of the masthead and the nav list when it appears above the content. The headings are given a tab index to allow the jump links to focus on them.

Scrollspy with subsections screenshot

With drawer

This demo shows how jump links can be used in combination with a drawer.

The scrollableSelector prop passed to the jump links component is an id that was placed on the DrawerContent component.

With drawer screenshot

View source on GitHub