Tabs
Sectioned content with switchable panels.
Setup
Tabs are included in manifest.js with all core plugins, or can be selectively loaded.
<script src="https://cdn.jsdelivr.net/npm/mnfst@latest/lib/manifest.min.js"></script>
Tabs draw their styles from any respective elements used, like buttons.
Default
Create tab menus with x-tab selectable targets and x-tabpanel content areas, using any HTML elements. Panels are targeted by matching the x-tab value with either the panel's id or its first class name.
<button x-tab="first">First</button>
<button x-tab="second">Second</button>
<div id="first" x-tabpanel>First content</div>
<div class="second" x-tabpanel>Second content</div>
The plugin works by automatically creating an Alpine property named tab (or tab_<group> for a named x-tabpanel group), which uses the x-tab values to show the selected panel and hide the others.
Wrap the buttons in an element with role="tablist" to opt into the full accessibility pattern — the plugin then adds role="tab", roving focus, and arrow-key navigation, and the wrapper picks up the tab bar styling with a sliding selected background. Plain buttons outside a tablist look the same whether selected or not; style [aria-selected="true"] to mark the active one (see Styles).
Shared Buttons
A tab button can show multiple panels simultaneously by using class names instead of IDs.
<button x-tab="shared">Show All</button>
<button x-tab="specific">Show Specific</button>
<!-- Multiple panels with same class -->
<div class="shared" x-tabpanel="classy">Shared content 1</div>
<div class="shared" x-tabpanel="classy">Shared content 2</div>
<!-- Single panel with ID -->
<div id="specific" x-tabpanel="classy">Specific content</div>
Multiple Tab Groups
By default, x-tabpanel content is part of the same tab group on the page. For additional independent groups, give each group's content a shared value, e.g. x-tabpanel="settings". This works the same as the name attribute for radio buttons. Keep the x-tab target names unique between groups — buttons match panels by id or class anywhere on the page, so groups reusing the same target names control each other.
<div class="col gap-2">
<small>Tab group A</small>
<div class="row gap-2">
<button x-tab="first-a">First</button>
<button x-tab="second-a">Second</button>
</div>
<div class="first-a" x-tabpanel="a">A. First content</div>
<div class="second-a" x-tabpanel="a">A. Second content</div>
</div>
<div class="col gap-2">
<small>Tab group B</small>
<div class="row gap-2">
<button x-tab="first-b">First</button>
<button x-tab="second-b">Second</button>
</div>
<div class="first-b" x-tabpanel="b">B. First content</div>
<div class="second-b" x-tabpanel="b">B. Second content</div>
</div>
Groups
Wrap tab buttons in a group wrapper to style the set as one control. role="group" connects the buttons flush with shared borders. role="tablist" makes a tab bar with a background that slides behind the selected tab, and opts into the full ARIA tabs pattern with arrow-key navigation.
<div role="group">
<button x-tab="metrics">Metrics</button>
<button x-tab="reports">Reports</button>
</div>
<div class="metrics" x-tabpanel="grouped">Metrics content</div>
<div class="reports" x-tabpanel="grouped">Reports content</div>
<div role="tablist">
<button x-tab="daily">Daily</button>
<button x-tab="weekly">Weekly</button>
</div>
<div class="daily" x-tabpanel="period">Daily content</div>
<div class="weekly" x-tabpanel="period">Weekly content</div>
Inactive Panels Cost Nothing
An unselected tab panel's contents are not initialized until the panel is first shown, so nothing in it runs while another tab is selected. A panel shown once stays ready. The same knobs as menus apply to a panel: x-defer.off keeps it eager, x-defer.discard throws its contents away each time it is hidden, and x-defer.priority="1" prepares it early. See performance for the full reference.
Styles
Tab buttons inherit from buttons. The plugin removes the x-tab and x-tabpanel attributes once it has wired them, so style tabs through the attributes it leaves in place.
| Selector | Purpose |
|---|---|
[aria-selected="true"] |
Selected tab button, synced by the plugin |
[role=tablist] > [role=tab] |
Tab buttons inside a tablist |
[role=tabpanel] |
Panels of a tablist |
Customization
Scope rules with a class of your own on the button wrapper so other tab groups are unaffected.
.tabs-underline > button {
border-bottom: 2px solid transparent;
border-radius: 0;
}
.tabs-underline > button[aria-selected="true"] {
border-bottom-color: var(--color-brand-content);
color: var(--color-brand-content);
}
Article does not exist
There is no documentation at this path.