NavList
NavListNavigation tree Render an already prepared navigation tree without the surrounding site panel controls.
Site navigation & servicesA small prepared tree
NavList expects stateful rows. Supply active/open state explicitly when using it outside NavMenu.
All ten semantic tones
Each row has an explicit tone. The NavList tone prop does not recolor rows by itself.
Samples follow this guide’s theme. Service appearance comparisons do not register account, search, or consent services.
Prepared row states
Active leaf Open group Closed group Empty tree NavList renders supplied state. The navigation runtime handles group toggles; NavMenu computes active paths and classes.
Feature map
| Feature | Where to explore it |
|---|---|
| Prepared rows, nested groups, explicit link tones, and current-page semantics | Context preview, feature comparisons, and original copyable source examples. |
| Public appearance options | Complete galleries above. Only options supported by this component are shown. |
| Native semantics and integration | Behavior notes and API contracts below explain the component’s roots, slots, and runtime dependencies. |
NavList exposes no variant or variantMode. Supply row tones, linkClass, ariaCurrent, isOpen, and stable stateKey values in the prepared items.
Behavior and accessibility
NavList renders a ul. Wrap it in a labelled nav when it is a standalone navigation region. Stable stateKey values identify groups to the navigation runtime. isActive alone does not compute link classes or ariaCurrent; NavMenu performs that preparation.
API reference
NavList contract
Props below are the public template API. RefOrValue accepts a literal or a reactive ref; bind refs with a colon-prefixed attribute. Native attributes and events can be passed through the component root.
Composition
No slots. Register defineNavigationComponents with BtnLink and Icon. The internal NavItem component is composed by NavList and is not a standalone public row API.