Components
Navs & tabs
Base nav, tabs, pills and underline — with working tab panes driven by radio inputs.
How it works
Static navs are unchanged Bootstrap: a .nav with .nav-link children and
.active on the current one. Tab panes are where the script used to be. Here each tab is
a visually hidden <input type="radio" class="nav-check"> followed by a
<label class="nav-link">; the nth checked radio shows the nth
.tab-pane.
- Baseline: radios +
:has()(Chrome 105, Safari 15.4, Firefox 121). Arrow keys move between radios, which is the WAI-ARIA tabs keyboard pattern for free. - Enhancement: none needed.
- Fallback: link-driven tabs with
<a href="#pane">and.tab-pane:target. Works everywhere, but the link itself is not highlighted.
.nav must be a direct child of .tabs,
.tab-content must be a direct child of .tabs, and each pane is the same
:nth-child as its tab. Up to 12 tabs per group. Do not add .fade to panes.Base nav
The base .nav is a flex container with the active-link colour in navy and hover in gold. Use a
list, or <nav> with plain links.
HTML
<ul class="nav">
<li class="nav-item">
<a class="nav-link active" aria-current="page" href="#!">Active</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#!">Link</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#!">Link</a>
</li>
<li class="nav-item">
<a class="nav-link disabled" aria-disabled="true">Disabled</a>
</li>
</ul>HTML
<nav class="nav">
<a class="nav-link active" aria-current="page" href="#!">Active</a>
<a class="nav-link" href="#!">Link</a>
<a class="nav-link" href="#!">Link</a>
<a class="nav-link disabled" aria-disabled="true">Disabled</a>
</nav>Horizontal alignment
Navs are left-aligned by default. Flex utilities move them.
HTML
<ul class="nav justify-content-center">
<li class="nav-item">
<a class="nav-link active" aria-current="page" href="#!">Active</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#!">Link</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#!">Link</a>
</li>
<li class="nav-item">
<a class="nav-link disabled" aria-disabled="true">Disabled</a>
</li>
</ul>HTML
<ul class="nav justify-content-end">
<li class="nav-item">
<a class="nav-link active" aria-current="page" href="#!">Active</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#!">Link</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#!">Link</a>
</li>
<li class="nav-item">
<a class="nav-link disabled" aria-disabled="true">Disabled</a>
</li>
</ul>Vertical
.flex-column stacks the nav. Responsive variants such as .flex-sm-column stack only below a breakpoint.
HTML
<ul class="nav flex-column">
<li class="nav-item">
<a class="nav-link active" aria-current="page" href="#!">Active</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#!">Link</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#!">Link</a>
</li>
<li class="nav-item">
<a class="nav-link disabled" aria-disabled="true">Disabled</a>
</li>
</ul>Tabs
Add .nav-tabs for the tabbed look. The active tab lifts off a bottom border; its corners use the 2px radius.
HTML
<ul class="nav nav-tabs">
<li class="nav-item">
<a class="nav-link active" aria-current="page" href="#!">Active</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#!">Link</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#!">Link</a>
</li>
<li class="nav-item">
<a class="nav-link disabled" aria-disabled="true">Disabled</a>
</li>
</ul>Pills
.nav-pills. The active pill is gold with navy text (gold-500 in dark mode).
HTML
<ul class="nav nav-pills">
<li class="nav-item">
<a class="nav-link active" aria-current="page" href="#!">Active</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#!">Link</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#!">Link</a>
</li>
<li class="nav-item">
<a class="nav-link disabled" aria-disabled="true">Disabled</a>
</li>
</ul>Underline
.nav-underline. The active link is bold with a 2px rule in the emphasis colour.
HTML
<ul class="nav nav-underline">
<li class="nav-item">
<a class="nav-link active" aria-current="page" href="#!">Active</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#!">Link</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#!">Link</a>
</li>
<li class="nav-item">
<a class="nav-link disabled" aria-disabled="true">Disabled</a>
</li>
</ul>Fill and justify
.nav-fill gives every item a proportional share of the width; .nav-justified makes them equal.
HTML
<ul class="nav nav-pills nav-fill">
<li class="nav-item">
<a class="nav-link active" aria-current="page" href="#!">Active</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#!">Much longer nav link</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#!">Link</a>
</li>
<li class="nav-item">
<a class="nav-link disabled" aria-disabled="true">Disabled</a>
</li>
</ul>HTML
<ul class="nav nav-pills nav-justified">
<li class="nav-item">
<a class="nav-link active" aria-current="page" href="#!">Active</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#!">Much longer nav link</a>
</li>
<li class="nav-item">
<a class="nav-link" href="#!">Link</a>
</li>
<li class="nav-item">
<a class="nav-link disabled" aria-disabled="true">Disabled</a>
</li>
</ul>With plain links in a <nav>, add .nav-item to each link so the fill rules apply.
HTML
<nav class="nav nav-pills nav-fill">
<a class="nav-link active nav-item" aria-current="page" href="#!">Active</a>
<a class="nav-link nav-item" href="#!">Much longer nav link</a>
<a class="nav-link nav-item" href="#!">Link</a>
<a class="nav-link nav-item disabled" aria-disabled="true">Disabled</a>
</nav>Working with flex utilities
For responsive variations, stack on small screens and fill horizontally from sm up.
HTML
<nav class="nav nav-pills flex-column flex-sm-row">
<a class="flex-sm-fill text-sm-center nav-link active" aria-current="page" href="#!">Active</a>
<a class="flex-sm-fill text-sm-center nav-link" href="#!">Longer nav link</a>
<a class="flex-sm-fill text-sm-center nav-link" href="#!">Link</a>
<a class="flex-sm-fill text-sm-center nav-link disabled" aria-disabled="true">Disabled</a>
</nav>Using dropdowns
A details dropdown fits inside a nav item. The <summary> takes
.nav-link.dropdown-toggle.
HTML
<ul class="nav nav-tabs">
<li class="nav-item">
<a class="nav-link active" aria-current="page" href="#!">Active</a>
</li>
<li class="nav-item">
<details class="dropdown">
<summary class="nav-link dropdown-toggle">Dropdown</summary>
<ul class="dropdown-menu">
<li><a class="dropdown-item" href="#!">Action</a></li>
<li><a class="dropdown-item" href="#!">Another action</a></li>
<li><a class="dropdown-item" href="#!">Something else here</a></li>
<li><hr class="dropdown-divider"></li>
<li><a class="dropdown-item" href="#!">Separated link</a></li>
</ul>
</details>
</li>
<li class="nav-item">
<a class="nav-link" href="#!">Link</a>
</li>
<li class="nav-item">
<a class="nav-link disabled" aria-disabled="true">Disabled</a>
</li>
</ul>HTML
<ul class="nav nav-pills">
<li class="nav-item">
<a class="nav-link active" aria-current="page" href="#!">Active</a>
</li>
<li class="nav-item">
<details class="dropdown">
<summary class="nav-link dropdown-toggle">Dropdown</summary>
<ul class="dropdown-menu">
<li><a class="dropdown-item" href="#!">Action</a></li>
<li><a class="dropdown-item" href="#!">Another action</a></li>
<li><a class="dropdown-item" href="#!">Something else here</a></li>
<li><hr class="dropdown-divider"></li>
<li><a class="dropdown-item" href="#!">Separated link</a></li>
</ul>
</details>
</li>
<li class="nav-item">
<a class="nav-link" href="#!">Link</a>
</li>
<li class="nav-item">
<a class="nav-link disabled" aria-disabled="true">Disabled</a>
</li>
</ul>Tab panes
Wrap the nav and the panes in .tabs. Each .nav-item holds a radio and a label; the
radios share a name. Mark the default tab checked. Click a label, or focus a tab and
use the arrow keys.
HTML
<div class="tabs">
<ul class="nav nav-tabs" role="tablist">
<li class="nav-item">
<input type="radio" class="nav-check" name="navs-tabs-demo" id="navs-tabs-demo-home" checked>
<label class="nav-link" for="navs-tabs-demo-home">Home</label>
</li>
<li class="nav-item">
<input type="radio" class="nav-check" name="navs-tabs-demo" id="navs-tabs-demo-profile">
<label class="nav-link" for="navs-tabs-demo-profile">Profile</label>
</li>
<li class="nav-item">
<input type="radio" class="nav-check" name="navs-tabs-demo" id="navs-tabs-demo-contact">
<label class="nav-link" for="navs-tabs-demo-contact">Contact</label>
</li>
<li class="nav-item">
<input type="radio" class="nav-check" name="navs-tabs-demo" id="navs-tabs-demo-disabled" disabled>
<label class="nav-link disabled" for="navs-tabs-demo-disabled">Disabled</label>
</li>
</ul>
<div class="tab-content pt-4">
<div class="tab-pane"><strong>Home.</strong> Tonight's card, the house show results and the odd kayfabe interview.</div>
<div class="tab-pane"><strong>Profile.</strong> Height, weight, hometown and the finisher. Stats that are mostly true.</div>
<div class="tab-pane"><strong>Contact.</strong> Write to the booker. The booker does not write back.</div>
<div class="tab-pane"><strong>Disabled.</strong> You should not be able to reach this pane.</div>
</div>
</div>Pills and underline tabs use the same structure with a different nav class.
HTML
<div class="tabs">
<ul class="nav nav-pills mb-4" role="tablist">
<li class="nav-item">
<input type="radio" class="nav-check" name="navs-tabs-pills" id="navs-tabs-pills-home" checked>
<label class="nav-link" for="navs-tabs-pills-home">Home</label>
</li>
<li class="nav-item">
<input type="radio" class="nav-check" name="navs-tabs-pills" id="navs-tabs-pills-profile">
<label class="nav-link" for="navs-tabs-pills-profile">Profile</label>
</li>
<li class="nav-item">
<input type="radio" class="nav-check" name="navs-tabs-pills" id="navs-tabs-pills-contact">
<label class="nav-link" for="navs-tabs-pills-contact">Contact</label>
</li>
</ul>
<div class="tab-content">
<div class="tab-pane"><strong>Home.</strong> This is the first pane.</div>
<div class="tab-pane"><strong>Profile.</strong> This is the second pane.</div>
<div class="tab-pane"><strong>Contact.</strong> This is the third pane.</div>
</div>
</div>HTML
<div class="tabs">
<ul class="nav nav-underline mb-4" role="tablist">
<li class="nav-item">
<input type="radio" class="nav-check" name="navs-tabs-underline" id="navs-tabs-underline-home" checked>
<label class="nav-link" for="navs-tabs-underline-home">Home</label>
</li>
<li class="nav-item">
<input type="radio" class="nav-check" name="navs-tabs-underline" id="navs-tabs-underline-profile">
<label class="nav-link" for="navs-tabs-underline-profile">Profile</label>
</li>
<li class="nav-item">
<input type="radio" class="nav-check" name="navs-tabs-underline" id="navs-tabs-underline-contact">
<label class="nav-link" for="navs-tabs-underline-contact">Contact</label>
</li>
</ul>
<div class="tab-content">
<div class="tab-pane"><strong>Home.</strong> This is the first pane.</div>
<div class="tab-pane"><strong>Profile.</strong> This is the second pane.</div>
<div class="tab-pane"><strong>Contact.</strong> This is the third pane.</div>
</div>
</div>Fill and justify work on tab navs too.
HTML
<div class="tabs">
<ul class="nav nav-pills nav-fill mb-4" role="tablist">
<li class="nav-item">
<input type="radio" class="nav-check" name="navs-tabs-fill" id="navs-tabs-fill-1" checked>
<label class="nav-link" for="navs-tabs-fill-1">Home</label>
</li>
<li class="nav-item">
<input type="radio" class="nav-check" name="navs-tabs-fill" id="navs-tabs-fill-2">
<label class="nav-link" for="navs-tabs-fill-2">Much longer nav link</label>
</li>
<li class="nav-item">
<input type="radio" class="nav-check" name="navs-tabs-fill" id="navs-tabs-fill-3">
<label class="nav-link" for="navs-tabs-fill-3">Contact</label>
</li>
</ul>
<div class="tab-content">
<div class="tab-pane">First pane.</div>
<div class="tab-pane">Second pane.</div>
<div class="tab-pane">Third pane.</div>
</div>
</div>Vertical pills
Make .tabs a flex row (.d-flex.align-items-start) with the column nav and the
content as its two direct children.
HTML
<div class="tabs d-flex align-items-start">
<ul class="nav flex-column nav-pills me-4" role="tablist" aria-orientation="vertical">
<li class="nav-item">
<input type="radio" class="nav-check" name="navs-tabs-vertical" id="navs-tabs-vertical-home" checked>
<label class="nav-link" for="navs-tabs-vertical-home">Home</label>
</li>
<li class="nav-item">
<input type="radio" class="nav-check" name="navs-tabs-vertical" id="navs-tabs-vertical-profile">
<label class="nav-link" for="navs-tabs-vertical-profile">Profile</label>
</li>
<li class="nav-item">
<input type="radio" class="nav-check" name="navs-tabs-vertical" id="navs-tabs-vertical-messages">
<label class="nav-link" for="navs-tabs-vertical-messages">Messages</label>
</li>
<li class="nav-item">
<input type="radio" class="nav-check" name="navs-tabs-vertical" id="navs-tabs-vertical-settings">
<label class="nav-link" for="navs-tabs-vertical-settings">Settings</label>
</li>
</ul>
<div class="tab-content">
<div class="tab-pane"><strong>Home.</strong> Vertical tabs pair by index exactly like horizontal ones.</div>
<div class="tab-pane"><strong>Profile.</strong> Second pane.</div>
<div class="tab-pane"><strong>Messages.</strong> Third pane.</div>
<div class="tab-pane"><strong>Settings.</strong> Fourth pane.</div>
</div>
</div>:target fallback
Link-driven tabs need no :has(). Each link points at a pane id; the targeted pane
shows and the default .active pane hides. Trade-offs: the active link is not
highlighted, the page scrolls to the pane, and the URL changes.
HTML
<ul class="nav nav-tabs">
<li class="nav-item"><a class="nav-link" href="#navs-tabs-target-home">Home</a></li>
<li class="nav-item"><a class="nav-link" href="#navs-tabs-target-profile">Profile</a></li>
<li class="nav-item"><a class="nav-link" href="#navs-tabs-target-contact">Contact</a></li>
</ul>
<div class="tab-content pt-4">
<div class="tab-pane active" id="navs-tabs-target-home"><strong>Home.</strong> Shown by default via <code>.active</code>.</div>
<div class="tab-pane" id="navs-tabs-target-profile"><strong>Profile.</strong> Shown by <code>:target</code>.</div>
<div class="tab-pane" id="navs-tabs-target-contact"><strong>Contact.</strong> Also <code>:target</code>.</div>
</div>Accessibility
- Use
<nav>for navigation navs, with anaria-labelwhen a page has more than one. - Radio tabs: the group of radios is one tab stop. Arrow keys move the selection; Tab moves on to the pane content. This matches the WAI-ARIA tabs pattern.
- Because the controls are real radios, screen readers announce "Home, radio button, 1 of 3, checked". Honest, if not the word "tab". You may add
role="tablist"on the list; do not putrole="tab"on the label, as it hides the radio semantics. - The gold focus ring is drawn on the label by
.nav-check:focus-visible + .nav-link. - Disable a tab by disabling its radio and adding
.disabledto the label.
CSS
All of Bootstrap's nav variables apply:
.nav {
--bs-nav-link-padding-x: 1rem;
--bs-nav-link-padding-y: 0.5rem;
--bs-nav-link-font-weight: ;
--bs-nav-link-color: var(--bs-link-color);
--bs-nav-link-hover-color: var(--bs-link-hover-color);
--bs-nav-link-disabled-color: var(--bs-secondary-color);
}
.nav-tabs {
--bs-nav-tabs-border-width: var(--bs-border-width);
--bs-nav-tabs-border-color: var(--bs-border-color);
--bs-nav-tabs-border-radius: 2px;
--bs-nav-tabs-link-hover-border-color: var(--bs-secondary-bg) var(--bs-secondary-bg) var(--bs-border-color);
--bs-nav-tabs-link-active-color: #0a1b3d;
--bs-nav-tabs-link-active-bg: var(--bs-body-bg);
--bs-nav-tabs-link-active-border-color: var(--bs-border-color) var(--bs-border-color) var(--bs-body-bg);
}
.nav-pills {
--bs-nav-pills-border-radius: 2px;
--bs-nav-pills-link-active-color: #0a1b3d;
--bs-nav-pills-link-active-bg: #b8941f; /* gold-500 in dark mode */
}
.nav-underline {
--bs-nav-underline-gap: 1rem;
--bs-nav-underline-border-width: 0.125rem;
--bs-nav-underline-link-active-color: var(--bs-emphasis-color);
}
Behavioural selectors added by the theme:
.nav-check // visually hidden radio
.nav-check:checked + .nav-link // active styles per variant (tabs, pills, underline, base)
.nav-check:focus-visible + .nav-link // focus ring
.tabs:has(> .nav > .nav-item:nth-child(n) > .nav-check:checked) > .tab-content > .tab-pane:nth-child(n)
// nth tab shows nth pane, n = 1…12
.tab-content > .tab-pane:target // link-driven pane
.tab-content:has(> .tab-pane:target) > .tab-pane.active:not(:target) // hides the default pane