Tabs
Tabs on Base UI Tabs whose highlight glides between triggers, in default and line variants.
Default
The project is on track: 14 of 20 tasks are done.
import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs"
export default function TabsDefault() {
return (
<Tabs defaultValue="overview" className="w-full max-w-sm">
<TabsList>
<TabsTrigger value="overview">Overview</TabsTrigger>
<TabsTrigger value="tasks">Tasks</TabsTrigger>
<TabsTrigger value="invoices">Invoices</TabsTrigger>
</TabsList>
<TabsContent value="overview">The project is on track: 14 of 20 tasks are done.</TabsContent>
<TabsContent value="tasks">Six tasks are open. Two are due this week.</TabsContent>
<TabsContent value="invoices">Three invoices were issued and one is awaiting payment.</TabsContent>
</Tabs>
)
}
Line
Tasks in one list, sorted by due date.
import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs"
export default function TabsLine() {
return (
<Tabs defaultValue="list" className="w-full max-w-sm">
<TabsList variant="line">
<TabsTrigger value="list">List</TabsTrigger>
<TabsTrigger value="board">Board</TabsTrigger>
<TabsTrigger value="timeline">Timeline</TabsTrigger>
</TabsList>
<TabsContent value="list">Tasks in one list, sorted by due date.</TabsContent>
<TabsContent value="board">Tasks in columns by status.</TabsContent>
<TabsContent value="timeline">Tasks on a calendar, by start and due date.</TabsContent>
</Tabs>
)
}
Vertical
The project name, its key and its default view.
import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs"
export default function TabsVertical() {
return (
<Tabs defaultValue="general" orientation="vertical" className="w-full max-w-sm">
<TabsList>
<TabsTrigger value="general">General</TabsTrigger>
<TabsTrigger value="members">Members</TabsTrigger>
<TabsTrigger value="billing">Billing</TabsTrigger>
</TabsList>
<TabsContent value="general">The project name, its key and its default view.</TabsContent>
<TabsContent value="members">Who can see the project and what each person can change.</TabsContent>
<TabsContent value="billing">The plan, the payment method and past invoices.</TabsContent>
</Tabs>
)
}
With icons
Tasks in one list, sorted by due date.
import { CalendarIcon, LayoutColumnsIcon, ListIcon } from "@keyline-icons/react"
import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs"
export default function TabsWithIcons() {
return (
<Tabs defaultValue="list" className="w-full max-w-sm">
<TabsList>
<TabsTrigger value="list">
<ListIcon data-icon="inline-start" />
List
</TabsTrigger>
<TabsTrigger value="board">
<LayoutColumnsIcon data-icon="inline-start" />
Board
</TabsTrigger>
<TabsTrigger value="timeline">
<CalendarIcon data-icon="inline-start" />
Timeline
</TabsTrigger>
</TabsList>
<TabsContent value="list">Tasks in one list, sorted by due date.</TabsContent>
<TabsContent value="board">Tasks in columns by status.</TabsContent>
<TabsContent value="timeline">Tasks on a calendar, by start and due date.</TabsContent>
</Tabs>
)
}
Disabled tab
Six tasks are open.
import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs"
export default function TabsDisabledTab() {
return (
<Tabs defaultValue="open" className="w-full max-w-sm">
<TabsList>
<TabsTrigger value="open">Open</TabsTrigger>
<TabsTrigger value="closed">Closed</TabsTrigger>
<TabsTrigger value="archived" disabled>
Archived
</TabsTrigger>
</TabsList>
<TabsContent value="open">Six tasks are open.</TabsContent>
<TabsContent value="closed">Fourteen tasks were closed this month.</TabsContent>
<TabsContent value="archived">Nothing has been archived.</TabsContent>
</Tabs>
)
}
Selecting on focus
Four tasks closed this week.
import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs"
export default function TabsSelectingOnFocus() {
return (
<Tabs defaultValue="week" className="w-full max-w-sm">
<TabsList activateOnFocus>
<TabsTrigger value="week">Week</TabsTrigger>
<TabsTrigger value="month">Month</TabsTrigger>
<TabsTrigger value="year">Year</TabsTrigger>
</TabsList>
<TabsContent value="week">Four tasks closed this week.</TabsContent>
<TabsContent value="month">Fourteen tasks closed this month.</TabsContent>
<TabsContent value="year">One hundred and sixty tasks closed this year.</TabsContent>
</Tabs>
)
}
Installation
npx shadcn@latest add @khaeli/tabsbunx --bun shadcn@latest add @khaeli/tabsInstall @khaeli/foundation first: this item's styling lives in its tokens and [data-slot] rules.
Installs with
- Registry items
- npm packages
- @base-ui/react ^1.7.0
- class-variance-authority ^0.7.1
Keyboard
Tab- Moves to the selected tab, then to its panel, which is focusable.
Arrow RightArrow Left- Move focus to the next or previous tab and wrap at the ends. With
orientation="vertical"the keys are Arrow Down and Arrow Up. A disabled tab takes focus but cannot be selected. HomeEnd- Move focus to the first or last tab.
EnterSpace- Select the focused tab and show its panel. With
activateOnFocusonTabsList, moving focus selects the tab straight away.
Accessible name
- A tab is named by its text; an icon beside the text is decorative. The selected tab has
aria-selected="true". - Each panel is named by its tab. A page with several sets of tabs should give each
TabsListanaria-label.
Registry JSON
The item as the shadcn CLI reads it, with every file it ships: https://ui.khaeli.com/r/tabs.json