Skip to main content
pnpm add @winkintel/bootstrap-svelte bootstrap@^5.3
GitHub
On this page

Tab

Tab components provide dynamic tabbed interfaces for organizing content into separate views that users can switch between.


Experiment with the Tab component by adjusting the props below:

Interactive Tab Playground

Controls

3 tabs
Active Tab

Preview

Home Content

This is the home tab content.

Code

            
            <Tab.Root>
  <Nav.Root itemStyle="tabs">
    <Nav.Item>
        <Tab.NavLink targetPaneId="#home" id="tab-home" isActive={true}>Home</Tab.NavLink>
    </Nav.Item>
    <Nav.Item>
        <Tab.NavLink targetPaneId="#profile" id="tab-profile" >Profile</Tab.NavLink>
    </Nav.Item>
    <Nav.Item>
        <Tab.NavLink targetPaneId="#contact" id="tab-contact" >Contact</Tab.NavLink>
    </Nav.Item>
  </Nav.Root>
  <Tab.Content>
    <Tab.Pane id="home" isActive={true} doFade={true}>
        <h5 class="mt-3">Home Content</h5>
        <p>This is the home tab content.</p>
    </Tab.Pane>
    <Tab.Pane id="profile"  doFade={true}>
        <h5 class="mt-3">Profile Content</h5>
        <p>This is the profile tab content.</p>
    </Tab.Pane>
    <Tab.Pane id="contact"  doFade={true}>
        <h5 class="mt-3">Contact Content</h5>
        <p>This is the contact tab content.</p>
    </Tab.Pane>
  </Tab.Content>
</Tab.Root>
        

The Tab component combines Nav components with tab content panes for creating a tabbed interface. The active tab is controlled by the isActive prop on both the Tab.NavLink and Tab.Pane components.

A Tab.NavLink inside a pane selects its destination and updates the matching strip tab. A bare Nav.Link does the same; under a Nav.Root in pane content, use Tab.NavLink to select a pane. If several strip links share a target, pane controls keep the selected match or choose the first registered strip link. A pane without a matching strip link leaves the strip unselected. Remounted links register last, even if they appear first in the markup. Removing the selected strip link selects a remaining match for the visible pane or clears strip selection. An initially active pane control does not change the initial pane or strip selection; clicks and later activation transitions still select its destination. Explicit Nav.Link isActive props continue to control their rendered active state.

Home Content

This is the home content panel.

            
            <Tab.Root>
    <Nav.Root itemStyle="tabs">
        <Nav.Item>
            <Tab.NavLink targetPaneId="#home" isActive={true}>Home</Tab.NavLink>
        </Nav.Item>
        <Nav.Item>
            <Tab.NavLink targetPaneId="#profile">Profile</Tab.NavLink>
        </Nav.Item>
        <Nav.Item>
            <Tab.NavLink targetPaneId="#messages">Messages</Tab.NavLink>
        </Nav.Item>
        <Nav.Item>
            <Tab.NavLink targetPaneId="#settings" isDisabled={true}>Disabled</Tab.NavLink>
        </Nav.Item>
    </Nav.Root>
    <Tab.Content>
        <Tab.Pane id="home" isActive={true}>
            <h5 class="mt-3">Home Content</h5>
            <p>This is the home content panel.</p>
        </Tab.Pane>
        <Tab.Pane id="profile">
            <h5 class="mt-3">Profile Content</h5>
            <p>This is the profile content panel.</p>
            <Tab.NavLink targetPaneId="#home">Return to Home</Tab.NavLink>
        </Tab.Pane>
        <Tab.Pane id="messages">
            <h5 class="mt-3">Messages Content</h5>
            <p>This is the messages content panel.</p>
        </Tab.Pane>
        <Tab.Pane id="settings">
            <h5 class="mt-3">Settings Content</h5>
            <p>This is the settings content panel.</p>
        </Tab.Pane>
    </Tab.Content>
</Tab.Root>
        

Add the doFade prop to your tab panes to enable a fade transition effect when switching between tabs.

Home Content with Fade

This tab will fade in and out when switching.

            
            <Tab.Root>
    <Nav.Root itemStyle="tabs">
        <Nav.Item>
            <Tab.NavLink targetPaneId="#home-fade" isActive={true}>Home</Tab.NavLink>
        </Nav.Item>
        <Nav.Item>
            <Tab.NavLink targetPaneId="#profile-fade">Profile</Tab.NavLink>
        </Nav.Item>
    </Nav.Root>
    <Tab.Content>
        <Tab.Pane id="home-fade" isActive={true} doFade={true}>
            <h5 class="mt-3">Home Content with Fade</h5>
            <p>This tab will fade in and out when switching.</p>
        </Tab.Pane>
        <Tab.Pane id="profile-fade" doFade={true}>
            <h5 class="mt-3">Profile Content with Fade</h5>
            <p>This tab will also fade in and out when switching.</p>
        </Tab.Pane>
    </Tab.Content>
</Tab.Root>
        

You can use pills instead of tabs by setting itemStyle="pills" on the Nav.Root component.

Home Pills Content

This is the pills-styled home tab content.

            
            <Tab.Root>
    <Nav.Root itemStyle="pills">
        <Nav.Item>
            <Tab.NavLink targetPaneId="#pills-home" isActive={true}>Home</Tab.NavLink>
        </Nav.Item>
        <Nav.Item>
            <Tab.NavLink targetPaneId="#pills-profile">Profile</Tab.NavLink>
        </Nav.Item>
        <Nav.Item>
            <Tab.NavLink targetPaneId="#pills-contact">Contact</Tab.NavLink>
        </Nav.Item>
    </Nav.Root>
    <Tab.Content>
        <Tab.Pane id="pills-home" isActive={true}>
            <h5 class="mt-3">Home Pills Content</h5>
            <p>This is the pills-styled home tab content.</p>
        </Tab.Pane>
        <Tab.Pane id="pills-profile">
            <h5 class="mt-3">Profile Pills Content</h5>
            <p>This is the pills-styled profile tab content.</p>
        </Tab.Pane>
        <Tab.Pane id="pills-contact">
            <h5 class="mt-3">Contact Pills Content</h5>
            <p>This is the pills-styled contact tab content.</p>
        </Tab.Pane>
    </Tab.Content>
</Tab.Root>
        

Stack your navigation by using the verticalBreakpoint="xs" prop on the Nav.Root component.

Home Content

This is the content for the home tab in vertical pills layout.

            
            <div class="d-flex align-items-start">
    <Tab.Root>
        <Nav.Root itemStyle="pills" verticalBreakpoint="xs" class="me-3">
            <Nav.Item>
                <Tab.NavLink targetPaneId="#v-pills-home" isActive={true}>Home</Tab.NavLink>
            </Nav.Item>
            <Nav.Item>
                <Tab.NavLink targetPaneId="#v-pills-profile">Profile</Tab.NavLink>
            </Nav.Item>
            <Nav.Item>
                <Tab.NavLink targetPaneId="#v-pills-messages">Messages</Tab.NavLink>
            </Nav.Item>
            <Nav.Item>
                <Tab.NavLink targetPaneId="#v-pills-settings">Settings</Tab.NavLink>
            </Nav.Item>
        </Nav.Root>
        <Tab.Content class="flex-grow-1">
            <Tab.Pane id="v-pills-home" isActive={true}>
                <h5 class="mt-0">Home Content</h5>
                <p>This is the content for the home tab in vertical pills layout.</p>
            </Tab.Pane>
            <Tab.Pane id="v-pills-profile">
                <h5 class="mt-0">Profile Content</h5>
                <p>This is the content for the profile tab in vertical pills layout.</p>
            </Tab.Pane>
            <Tab.Pane id="v-pills-messages">
                <h5 class="mt-0">Messages Content</h5>
                <p>This is the content for the messages tab in vertical pills layout.</p>
            </Tab.Pane>
            <Tab.Pane id="v-pills-settings">
                <h5 class="mt-0">Settings Content</h5>
                <p>This is the content for the settings tab in vertical pills layout.</p>
            </Tab.Pane>
        </Tab.Content>
    </Tab.Root>
</div>
        

To proportionately fill all available space with your nav items, use itemLayout="fill" or itemLayout="justified" on the Nav.Root component. The "fill" option gives all nav items equal width, while "justified" gives them equal width but only when all horizontal space is occupied.

Fill Example
Fill Tab Home

This content appears with the nav items filling the available width.

            
            <Tab.Root>
    <Nav.Root itemStyle="pills" itemLayout="fill">
        <Nav.Item>
            <Tab.NavLink targetPaneId="#fill-home" isActive={true}>Home</Tab.NavLink>
        </Nav.Item>
        <Nav.Item>
            <Tab.NavLink targetPaneId="#fill-profile">Profile</Tab.NavLink>
        </Nav.Item>
        <Nav.Item>
            <Tab.NavLink targetPaneId="#fill-contact">Contact</Tab.NavLink>
        </Nav.Item>
    </Nav.Root>
    <Tab.Content>
        <Tab.Pane id="fill-home" isActive={true}>
            <h5 class="mt-3">Fill Tab Home</h5>
            <p>This content appears with the nav items filling the available width.</p>
        </Tab.Pane>
        <Tab.Pane id="fill-profile">
            <h5 class="mt-3">Fill Tab Profile</h5>
            <p>This content appears with the nav items filling the available width.</p>
        </Tab.Pane>
        <Tab.Pane id="fill-contact">
            <h5 class="mt-3">Fill Tab Contact</h5>
            <p>This content appears with the nav items filling the available width.</p>
        </Tab.Pane>
    </Tab.Content>
</Tab.Root>
        

You can add custom CSS classes to each component in the Tab structure to further customize styling.

Home with Custom Classes

This is the content with custom CSS classes applied.

            
            <Tab.Root>
    <Nav.Root itemStyle="tabs" class="mb-3 nav-custom">
        <Nav.Item class="custom-item">
            <Tab.NavLink targetPaneId="#custom-home" isActive={true} class="rounded-top">Home</Tab.NavLink>
        </Nav.Item>
        <Nav.Item class="custom-item">
            <Tab.NavLink targetPaneId="#custom-profile" class="rounded-top">Profile</Tab.NavLink>
        </Nav.Item>
    </Nav.Root>
    <Tab.Content class="border p-3 custom-content">
        <Tab.Pane id="custom-home" isActive={true} class="custom-pane">
            <h5>Home with Custom Classes</h5>
            <p>This is the content with custom CSS classes applied.</p>
        </Tab.Pane>
        <Tab.Pane id="custom-profile" class="custom-pane">
            <h5>Profile with Custom Classes</h5>
            <p>This is the content with custom CSS classes applied.</p>
        </Tab.Pane>
    </Tab.Content>
</Tab.Root>
        

Tab.Root Props

NameTypeDefaultDescription
classstring-Additional CSS classes to apply to the component
elementRefHTMLElement | nullnullReference to the DOM element
idstringAuto-generatedUnique identifier for the tab container

Tab.Content Props

NameTypeDefaultDescription
classstring-Additional CSS classes to apply to the component
elementRefHTMLElement | nullnullReference to the DOM element

Tab.NavLink Props

NameTypeDefaultDescription
classstring-Additional CSS classes to apply to the component
elementRefHTMLElement | nullnullReference to the DOM element
idstringAuto-generatedUnique identifier for the link
isActivebooleanfalseWhether the link is active
isDisabledbooleanfalseWhether the link is disabled
role'button' | 'tab'Auto-determinedARIA role for the link. Defaults to 'tab' in a tab strip; explicit roles and null are honored.
targetPaneIdstring'#!'The ID of the tab pane to link to.

Tab.Pane Props

NameTypeDefaultDescription
classstring-Additional CSS classes to apply to the component
doFadebooleanfalseWhether to use fade transition when showing/hiding
elementRefHTMLElement | nullnullReference to the DOM element
idstringAuto-generatedUnique identifier for the tab pane
isActivebooleanfalseWhether the pane is initially visible
onHidefunctionnoopCallback when the pane is about to be hidden
onHiddenfunctionnoopCallback when the pane has been hidden
onShowfunctionnoopCallback when the pane is about to be shown
onShownfunctionnoopCallback when the pane has been shown

CSS Classes

The component applies Bootstrap's tab classes based on the provided props:

  • tab-content - Applied to Tab.Content components
  • tab-pane - Applied to Tab.Pane components
  • active - Applied to Tab.Pane when isActive=true
  • fade - Applied to Tab.Pane when doFade=true
  • show - Applied to Tab.Pane during transition when doFade=true

Accessibility

In a Tab.Root strip with a tablist container, Tab.NavLink and Nav.Link support automatic activation: Right/Down Arrow selects and focuses the next enabled tab, and Left/Up Arrow selects and focuses the previous one, wrapping at either end. Home and End select and focus the first and last enabled tabs. All four arrows work in either orientation, matching Bootstrap. Keyboard order follows the current DOM order within that tablist; nested roots and other tablists stay separate. Modified keys (Alt, Ctrl, Meta or Shift) and composition events retain their native behavior.

By default, the selected enabled tab has tabindex="0" and the others have tabindex="-1". If no enabled tab is selected, the first enabled tab becomes the entry point after mount; an all-disabled list has no entry point. Removing or disabling tabs updates entry without moving focus. Disabled links reject clicks, including synthetic clicks, before selection or consumer click callbacks. Strip links outside a tablist retain their native tab stops and do not manage arrow keys. Tabs use aria-selected and omit aria-current.

Explicit link roles are honored; a non-tab role opts the link out of automatic tab ARIA and keyboard handling. Root role overrides other than tablist also opt out. Pane controls retain ordinary button/link behavior. Explicit tabindex values override roving defaults on enabled links, so callers supplying them own tab-sequence consistency. Explicit Nav.Link isActive props still control rendered selection; synchronize those props in the application when controlling tabs. Keyboard activation invokes the destination link’s existing onclick callback, just like a click. Consumer onkeydown runs first and may call preventDefault() to cancel a managed key. Use pane lifecycle callbacks such as onShow and onShown to observe pane changes from either clicks or keyboard selection.

Tab.NavLink preserves explicit aria-controls and aria-selected overrides; callers supplying them must keep panel associations and selection coherent. Nav.Link retains its existing managed tab ARIA priority. Omit these overrides to use automatic selection and panel associations.

For controlled Nav.Link tabs, update the active value through the existing click callback:

            
            <script>
    import { Nav, Tab } from '@winkintel/bootstrap-svelte';
    let active = $state('home');
</script>

<Tab.Root>
    <Nav.Root aria-label="Account">
        <Nav.Link href="#home" isActive={active === 'home'} onclick={() => active = 'home'}>Home</Nav.Link>
        <Nav.Link href="#profile" isActive={active === 'profile'} onclick={() => active = 'profile'}>Profile</Nav.Link>
    </Nav.Root>
    <Tab.Pane id="home" isActive={active === 'home'}>Home content</Tab.Pane>
    <Tab.Pane id="profile" isActive={active === 'profile'}>Profile content</Tab.Pane>
</Tab.Root>
        

The Tab component automatically applies proper ARIA attributes:

  • role="tablist" - Applied by default to the Nav.Root strip in Tab.Root for every visual style; Nav inside Tab.Pane stays ordinary
  • role="tabpanel" - Applied to Tab.Pane components
  • aria-labelledby - Links the Tab.Pane to its corresponding Tab.NavLink
  • aria-hidden - Set to "true" for inactive panes, "false" for active panes
  • hidden - HTML attribute applied to inactive panes