A labelled, sectioned navigation landmark with real links, current-page state, disabled text, and optional badges.
Since
1.0.0-next.0
Owner
Brand Core
Export
PRIVATE_BETA_PACKAGE_COORDINATE_REDACTED/SideNav
Release
Documentation version
Deterministic fixture · default state
Component studio
Recent decisions3 events
allow user:ada → portal:docs
deny user:lin → key:prod
allow service:sync → schema:main
Preview controls could not be applied. The static default fixture remains available.
§01
Contract
Semantics first
Anatomy
Uses nav, section headings, lists, anchors, and aria-current=page; disabled destinations render as non-link text.
Consumer classes, styles, and data attributes may extend the surface, but required roles, IDs, relationships, and handlers remain owned by the component.
Keyboard
Tab reaches enabled links in document order.
Enter follows the focused link.
Disabled destinations are perceivable but are not tab stops.
§02
Public surface
API & styling
Props
id
Explicit IDs override stable generated IDs.
class / style
Consumer additions compose with required styles.
ref
Element or callback where focus control is expected.
children
Typed content; raw HTML strings are never rendered.
Slots & events
children
Primary content slot.
onChange
Typed value plus a small reason object when state changes.
There is no stable predecessor for this explicit compiled subpath. The v1 compatibility layer remains tested separately; visual and API diffs begin with the next prerelease.