Overview Button Copy button Field Input Number field Textarea Select Combobox Multiselect Date picker Date range picker Date-time picker Checkbox Radio group Position picker Switch Slider Dropzone Device controls Avatar Badge Card Collapsible Kbd Map Matrix Proportion bar Separator Stat Table Timeline Chat Playback Pagination Charts Chart theming Profile chart Time series chart Bar chart Isopleth chart TS diagram Box plot Rose chart Calendar chart Banner Toast Loader Progress Skeleton Empty state Error state Dropdown menu Tooltip Info tooltip Dialog Sheet Resizable Confirm dialog Breadcrumbs Command palette Mobile menu Navigation list Outline Scroll rail Sidebar Tabs
Navigation list
A second sidebar inside the content, for a section with many sibling pages. Text only, grouped by spacing, with the same active look as the app sidebar.
Default
Click an item. The longest matching href is active, so nested pages keep their parent lit.
General
The page's own content goes here.
<NavigationList
label="Settings"
current={page.url.pathname}
groups={[
{ label: 'Your account', items: [{ label: 'Profile', href: '/settings/profile' }] },
{ label: 'Organization', items: [{ label: 'Members', href: '/settings/members' }] },
]}
class="sticky top-10 w-44 shrink-0 self-start"
/> Tabs or navigation list
Both switch between pages under one place. Pick by what the pages are, not by how many fit.
Tabs
Views of one thing.
- The page has a subject, like a project, a vessel or a mission, and each tab is another view of it.
- Two to six tabs, on one line. Never grouped.
- People flip between them; the title and header above stay put.
For example: Project: Overview, Missions, Data, Files.
Navigation list
A section made of many pages.
- Each page stands on its own, with its own title. People go to one and stay.
- Seven or more pages, or a list that will grow. Falls into labelled groups.
- The app sidebar holds one item for the whole section; its pages live here.
For example: Settings, admin, these docs.
- In doubt, tabs: they keep the subject in view and cost no width.
- A page inside a navigation list can have tabs. A navigation list never sits inside another, or inside a tab.
- Below the md breakpoint a navigation list turns into tabs, flat, without its group labels.