Navbar
Navigation and actions for the current screen.
When to use
Use a navbar for the application brand and primary destinations. Keep the current location clear, and use a Drawer when compact viewports need a separate navigation panel.
Default
Use .navbar for primary navigation.
<nav class="navbar">
<div class="container">
<span class="h4 mb-0">Nav Title</span>
</div>
</nav>Background colors
Combine .navbar with a background utility.
<nav class="navbar bg-primary">
<div class="container">
<span class="h4 mb-0">Nav Title</span>
</div>
</nav>
<nav class="navbar bg-secondary">
<div class="container">
<span class="h4 mb-0">Nav Title</span>
</div>
</nav>
<nav class="navbar bg-success">
<div class="container">
<span class="h4 mb-0">Nav Title</span>
</div>
</nav>
<nav class="navbar bg-warning">
<div class="container">
<span class="h4 mb-0">Nav Title</span>
</div>
</nav>
<nav class="navbar bg-error">
<div class="container">
<span class="h4 mb-0">Nav Title</span>
</div>
</nav>Inverse navbar
Use .bg-inverse for automatic contrasting text.
<nav class="navbar bg-inverse">
<div class="container">
<span class="h4 mb-0">Nav Title</span>
</div>
</nav>Logo
Use .navbar-logo for the brand link.
<nav class="navbar bg-surface">
<div class="container">
<a class="navbar-logo" href="#">Navbar Logo</a>
</div>
</nav>Accessibility and behavior
- Use a labelled
navlandmark when the bar contains navigation. Distinguish its name from breadcrumbs and other navigation landmarks. - Use real links for destinations and
aria-current="page"on the current page link. Keep branding understandable through visible text or meaningful image alternative text. - Let links wrap or provide an explicitly controlled compact navigation pattern. The navbar styles do not implement a mobile toggle or drawer lifecycle.
CSS variables
Override these base defaults on the listed selector after the library styles. Variants and states may replace them; global tokens follow the active theme.
| Token | Default | Purpose | Scope / state |
|---|---|---|---|
--navbar-bg-color | var(--bg-surface) | Background color. | .navbar |
--navbar-text-color | var(--text-color) | Text color. | .navbar |
--navbar-padding-y | var(--spacer-2) | Top and bottom padding. | .navbar |
--navbar-padding-x | var(--spacer-0) | Left and right padding. | .navbar |
--navbar-min-height | 3.75rem | Minimum height. | .navbar |
--navbar-link-color | var(--navbar-text-color) | Navigation link color. | .navbar |
--navbar-link-hover-color | var(--action-color-hover) | Navigation link color on hover. | .navbar |
--navbar-link-active-color | var(--action-color-active) | Navigation link color when pressed. | .navbar |
--navbar-logo-hover-color | var(--action-color-hover) | Logo link color on hover. | .navbar |
--navbar-logo-active-color | var(--action-color-active) | Logo link color when pressed. | .navbar |