Navbar.
The top of every page, at every width.
Navbar is a header landmark with Brand, Content, Actions, a Toggle and a Menu. Below collapseBelow, measured on the bar itself with a container query, Content hides and the Base UI Collapsible menu takes over. Following a link closes the menu.
Make it yours
Preparing the example…
Composition
AnatomyNavbar is a header landmark with Brand, Content, Actions, a Toggle and a Menu. Below collapseBelow, measured on the bar itself with a container query, Content hides and the Base UI Collapsible menu takes over. Following a link closes the menu.
Navbar.Root (header, Collapsible.Root)
├── Navbar.Brand
├── Navbar.Content (nav > ul)
│ └── Navbar.Item (li) > Navbar.Link (aria-current)
├── Navbar.Actions
├── Navbar.Toggle (Collapsible.Trigger, aria-expanded)
└── Navbar.Menu (Collapsible.Panel > nav > ul)A place to start
UsageImport the stylesheet once at your application root. This complete example reflects the properties selected above.
Loading example…
Details that make a difference
Examples & statesSizes
Compare the three Dixy shirt sizes side by side.
Loading source…
Visual treatments
Emphasis changes presentation while the primitive keeps behavior.
Loading source…
Corner radii
Contextual rounding applies to the control or surface; large panels stay readable.
Loading source…
Materials
Optional static finishes use the same public component. Import materials.css in your application.
Loading source…
The finer details
API referenceGenerated from Dixy’s local TypeScript interfaces. Native HTML attributes and refs are forwarded. The table covers Dixy’s own options.
Navbar
| Prop | Type / description | Default |
|---|---|---|
size | "sm" | "md" | "lg"Bar height and type size. | md |
variant | "soft" | "outline" | "ghost"Surface emphasis. | outline |
radius | "none" | "sm" | "md" | "lg" | "full"Rounding for links and the toggle. | Theme.radius |
material | "matte" | "glossy" | "soft" | "metal" | "paper"Optional static finish; import materials.css. | Theme.material |
collapseBelow | "sm" | "md" | "lg" | "never"Bar width below which Content hides and the Toggle and Menu appear. Actions stay visible. "never" always shows Content. | md (48rem) |
sticky | booleanKeep the bar at the top of its scroll container. | false |
NavbarContent
| Prop | Type / description | Default |
|---|---|---|
as | EOverride the semantic element, e.g. a title heading level. | — |
aria-label | stringLandmark name. | Main |
NavbarLink
| Prop | Type / description | Default |
|---|---|---|
as | EOverride the semantic element, e.g. a title heading level. | — |
active | booleanMarks the current page with aria-current="page". | false |
NavbarToggle
| Prop | Type / description | Default |
|---|---|---|
aria-label | stringAccessible name; aria-expanded conveys open state. | Menu |
NavbarMenu
| Prop | Type / description | Default |
|---|---|---|
aria-label | stringLandmark name; matches Content because only one is visible at a time. | Main |
Built from the same foundations
Styling tokensChange Theme settings above to compare appearance, accent, neutral, radius, spacing density, motion and direction. Override component aliases on a Theme root so custom properties follow portaled content too. The wrapper merges className, style, refs and render composition with its owning primitive.
| Token | Purpose |
|---|---|
--dixy-color-border-subtle | The component-specific starting point. |
--dixy-font-label-md | Control label font and line height; body roles remain readable in text inputs. |
--dixy-color-background-selected | Selected surfaces use semantic color across appearances. |
--dixy-color-border-focus | Focus indication remains visible independently of shadows. |
--dixy-spacing-inset-sm | Density-aware component padding. |
--dixy-motion-transition-feedback | Short state feedback, reduced by the inherited motion setting. |
Consider everyone
AccessibilityOnly one of Content or Menu is displayed at a time, so a single Main navigation landmark is exposed. The toggle's aria-expanded reports the menu state; the current page uses aria-current. Target WCAG 2.2 AA. Automated axe checks pass in unit tests; screen-reader, forced-colors and contrast verification in real browsers remains pending.
Target: WCAG 2.2 AA. Automated tests cover selected behavior; manual screen-reader, contrast, and zoom validation remain part of the release checklist.
Build it. Then understand it.
Container queries respond to the component's width, not the viewport, so the same Navbar collapses correctly inside a sidebar layout or a narrow preview.
--dixy-color-border-subtle