Skip to main content

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.
Pairing is by position. .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.

Home. Tonight's card, the house show results and the odd kayfabe interview.
Profile. Height, weight, hometown and the finisher. Stats that are mostly true.
Contact. Write to the booker. The booker does not write back.
Disabled. You should not be able to reach this pane.
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.

Home. This is the first pane.
Profile. This is the second pane.
Contact. This is the third pane.
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>
Home. This is the first pane.
Profile. This is the second pane.
Contact. This is the third pane.
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.

First pane.
Second pane.
Third pane.
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.

Home. Vertical tabs pair by index exactly like horizontal ones.
Profile. Second pane.
Messages. Third pane.
Settings. Fourth pane.
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 an aria-label when 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 put role="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 .disabled to 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