Navigation

ScrollSpy

A list of in-page anchor links that highlights the section currently in view.

html
<UiScrollSpy :links="..." />

Title

title is a heading above the list. Leave it off where the surrounding column already says what the list is.

Color

color is the active link's color, and the indicator bar beside it.

Which link is active is still resolved by CSS scroll-target-group/:target-current (Chromium 133+), not scroll-spy math — a scroll/resize listener only checks that browser-computed state on each tick so the indicator bar can animate to the new position; on unsupported browsers the links still work, just without the active-state color or bar.

The sliding indicator bar's color comes from color via a bg-* class, separate from the text-* class applied to the active link's text — keep custom color values in sync with any theme overrides so the two don't drift apart.


API Reference

Generated from the component's source — props, slots and emits as the component actually declares them.

Props

Prop
Type
Default
Description
linksrequired
ScrollSpyLink[]
The headings to link to, each pointing at an element with a matching `id` in the page.
string
Heading text displayed above the list of links.
"neutral" | "primary" | "secondary" | "success" | "error" | "warning" | "info" | "pending"
'neutral'
The color of the active link.

Types

ts
interface ScrollSpyLink {
    id: string;
    text: string;
    depth: number;
}