Overview
Get Started
Tabs
A component for toggling between related panels on the same page.
Tab 1 content
import { Tabs, TabsList, TabsPanel, TabsTab } from "@/components/ui/tabs";
export function TabsDemo() {
return (
<Tabs defaultValue="tab-1">
<TabsList>
<TabsTab value="tab-1">Tab 1</TabsTab>
<TabsTab value="tab-2">Tab 2</TabsTab>
<TabsTab value="tab-3">Tab 3</TabsTab>
</TabsList>
<TabsPanel value="tab-1" className="rounded-lg border">
<p className="p-5 text-center text-muted-foreground text-xs">Tab 1 content</p>
</TabsPanel>
<TabsPanel value="tab-2" className="rounded-lg border">
<p className="p-5 text-center text-muted-foreground text-xs">Tab 2 content</p>
</TabsPanel>
<TabsPanel value="tab-3" className="rounded-lg border">
<p className="p-5 text-center text-muted-foreground text-xs">Tab 3 content</p>
</TabsPanel>
</Tabs>
);
}Installation
import { Tabs as TabsPrimitive } from "@base-ui/react/tabs";
import { cn } from "@/lib/cn";
type TabsVariant = "default" | "underline";
function Tabs({ className, ...props }: React.ComponentProps<typeof TabsPrimitive.Root>) {
return (
<TabsPrimitive.Root
data-slot="tabs"
className={cn("flex flex-col gap-2 data-[orientation=vertical]:flex-row", className)}
{...props}
/>
);
}
function TabsList({
variant = "default",
className,
children,
...props
}: React.ComponentProps<typeof TabsPrimitive.List> & {
variant?: TabsVariant;
}) {
return (
<TabsPrimitive.List
data-slot="tabs-list"
className={cn(
"relative z-0 flex w-fit items-center justify-center gap-x-0.5 text-muted-foreground",
"text-muted-foreground/70 data-[orientation=vertical]:flex-col",
variant === "default"
? "rounded-lg bg-muted p-0.5"
: "data-[orientation=vertical]:px-1 data-[orientation=horizontal]:py-1",
className
)}
{...props}
>
{children}
<TabsPrimitive.Indicator
className={cn(
"absolute bottom-0 left-0 h-(--active-tab-height) w-(--active-tab-width) translate-x-(--active-tab-left) -translate-y-(--active-tab-bottom) transition-[width,translate] duration-200 ease-in-out",
variant === "underline"
? "z-10 bg-primary data-[orientation=horizontal]:h-0.5 data-[orientation=vertical]:w-0.5 data-[orientation=vertical]:-translate-x-px data-[orientation=horizontal]:translate-y-px"
: "-z-1 rounded-md bg-background shadow-sm/5 dark:bg-input"
)}
data-slot="tab-indicator"
/>
</TabsPrimitive.List>
);
}
function TabsTab({ className, ...props }: React.ComponentProps<typeof TabsPrimitive.Tab>) {
return (
<TabsPrimitive.Tab
data-slot="tabs-tab"
className={cn(
"flex h-9 shrink-0 grow cursor-pointer select-none items-center justify-center gap-1.5 whitespace-nowrap rounded-md border border-transparent px-2.5 font-medium text-sm outline-none transition-[color,background-color,box-shadow] hover:text-muted-foreground focus-visible:ring-2 focus-visible:ring-ring data-disabled:pointer-events-none data-[orientation=vertical]:w-full data-[orientation=vertical]:justify-start data-active:text-foreground data-disabled:opacity-60 [&_svg:not([class*='size-'])]:size-4 [&_svg]:pointer-events-none [&_svg]:-mx-0.5 [&_svg]:shrink-0",
className
)}
{...props}
/>
);
}
function TabsPanel({ className, ...props }: React.ComponentProps<typeof TabsPrimitive.Panel>) {
return (
<TabsPrimitive.Panel
data-slot="tabs-panel"
className={cn("flex-1 outline-none", className)}
{...props}
/>
);
}
export { Tabs, TabsList, TabsTab, TabsTab as TabsTrigger, TabsPanel, TabsPanel as TabsContent };Usage
import { Tabs, TabsList, TabsPanel, TabsTab } from "@/components/ui/tabs";<Tabs defaultValue="tab-1">
<TabsList>
<TabsTab value="tab-1">Tab 1</TabsTab>
<TabsTab value="tab-2">Tab 2</TabsTab>
<TabsTab value="tab-3">Tab 3</TabsTab>
</TabsList>
<TabsPanel value="tab-1">
<p>Tab 1 content</p>
</TabsPanel>
<TabsPanel value="tab-2">
<p>Tab 2 content</p>
</TabsPanel>
<TabsPanel value="tab-3">
<p>Tab 3 content</p>
</TabsPanel>
</Tabs>Examples
Underline variant
Pass variant="underline" prop to TabsList to use the underline style for the tabs.
Tab 1 content
import { Tabs, TabsList, TabsPanel, TabsTab } from "@/components/ui/tabs";
export function TabsDemo() {
return (
<Tabs defaultValue="tab-1">
<TabsList variant="underline">
<TabsTab value="tab-1">Tab 1</TabsTab>
<TabsTab value="tab-2">Tab 2</TabsTab>
<TabsTab value="tab-3">Tab 3</TabsTab>
</TabsList>
<TabsPanel value="tab-1" className="rounded-lg border">
<p className="p-5 text-center text-muted-foreground text-xs">Tab 1 content</p>
</TabsPanel>
<TabsPanel value="tab-2" className="rounded-lg border">
<p className="p-5 text-center text-muted-foreground text-xs">Tab 2 content</p>
</TabsPanel>
<TabsPanel value="tab-3" className="rounded-lg border">
<p className="p-5 text-center text-muted-foreground text-xs">Tab 3 content</p>
</TabsPanel>
</Tabs>
);
}