Get Started
Input
Feedback
Display
Installation
i18n
A set of layered sections of content—known as tab panels—that are displayed one at a time.
Overview
View your key metrics and recent project activity. Track progress across all your active projects.
You have 12 active projects and 3 pending tasks.
import {
Card,
CardContent,Installation#
pnpm dlx shadcn@latest add https://ui.tyap.me/r/styles/base/tabs.jsonnpx shadcn@latest add https://ui.tyap.me/r/styles/base/tabs.jsonyarn dlx shadcn@latest add https://ui.tyap.me/r/styles/base/tabs.jsonbunx --bun shadcn@latest add https://ui.tyap.me/r/styles/base/tabs.json
Install the following dependencies:
pnpm add @base-ui/reactnpm install @base-ui/reactyarn add @base-ui/reactbun add @base-ui/react
Copy and paste the following code into your project.
"use client"
import * as React from "react"
import { Tabs as TabsPrimitive } from "@base-ui/react/tabs"
import { cva, type VariantProps } from "class-variance-authority"
import { cn } from "@/lib/utils"
const TABS_ANIMATION_CSS = `
.cn-tabs-content {
transition:
opacity 280ms cubic-bezier(0.22, 1, 0.36, 1),
transform 400ms cubic-bezier(0.22, 1, 0.36, 1);
will-change: opacity, transform;
}
@starting-style {
.cn-tabs-content:not([hidden]) {
opacity: 0;
transform: translateY(6px);
}
.cn-tabs-content[data-direction="forward"]:not([hidden]) {
opacity: 0;
transform: translateX(40px);
}
.cn-tabs-content[data-direction="backward"]:not([hidden]) {
opacity: 0;
transform: translateX(-40px);
}
}
@media (prefers-reduced-motion: reduce) {
.cn-tabs-content { transition: none !important; }
}
`
type TabsCtxValue = {
direction: "forward" | "backward" | null
registerTab: (value: string) => () => void
}
type TabsValueChange = NonNullable<TabsPrimitive.Root.Props["onValueChange"]>
type TabsValue = Parameters<TabsValueChange>[0]
type TabsChangeDetails = Parameters<TabsValueChange>[1]
const TabsCtx = React.createContext<TabsCtxValue>({
direction: null,
registerTab: () => () => {},
})
function Tabs({
className,
orientation = "horizontal",
onValueChange,
defaultValue,
value: valueProp,
...props
}: TabsPrimitive.Root.Props) {
const tabOrderRef = React.useRef<string[]>([])
const prevValueRef = React.useRef<string | null>(
(defaultValue ?? valueProp ?? null) as string | null
)
const [direction, setDirection] = React.useState<
"forward" | "backward" | null
>(null)
const registerTab = React.useCallback((value: string) => {
tabOrderRef.current = [...tabOrderRef.current, value]
return () => {
tabOrderRef.current = tabOrderRef.current.filter((v) => v !== value)
}
}, [])
const handleValueChange = React.useCallback(
(newValue: TabsValue | null, eventDetails: TabsChangeDetails) => {
if (newValue == null) return
const prev = prevValueRef.current
const nextValue = String(newValue)
if (prev != null && prev !== nextValue) {
const order = tabOrderRef.current
const prevIdx = order.indexOf(prev)
const nextIdx = order.indexOf(nextValue)
if (prevIdx !== -1 && nextIdx !== -1) {
setDirection(nextIdx > prevIdx ? "forward" : "backward")
}
}
prevValueRef.current = nextValue
onValueChange?.(newValue, eventDetails)
},
[onValueChange]
)
return (
<TabsCtx.Provider value={{ direction, registerTab }}>
<style precedence="component" href="cn-tabs-animation">
{TABS_ANIMATION_CSS}
</style>
<TabsPrimitive.Root
data-slot="tabs"
data-orientation={orientation}
defaultValue={defaultValue}
value={valueProp}
onValueChange={
handleValueChange as TabsPrimitive.Root.Props["onValueChange"]
}
className={cn(
"group/tabs flex data-horizontal:flex-col",
className
)}
{...props}
/>
</TabsCtx.Provider>
)
}
const tabsListVariants = cva(
"group/tabs-list inline-flex w-fit items-center justify-center group-data-vertical/tabs:h-fit group-data-vertical/tabs:flex-col",
{
variants: {
variant: {
default: "bg-muted",
line: "gap-2 bg-transparent",
},
},
defaultVariants: {
variant: "default",
},
}
)
function TabsList({
className,
variant = "default",
...props
}: TabsPrimitive.List.Props & VariantProps<typeof tabsListVariants>) {
return (
<TabsPrimitive.List
data-slot="tabs-list"
data-variant={variant}
className={cn(tabsListVariants({ variant }), className)}
{...props}
/>
)
}
function TabsTrigger({ className, value, ...props }: TabsPrimitive.Tab.Props) {
const { registerTab } = React.useContext(TabsCtx)
React.useLayoutEffect(() => {
if (value == null) return
return registerTab(String(value))
}, [value, registerTab])
return (
<TabsPrimitive.Tab
data-slot="tabs-trigger"
value={value}
className={cn(
"relative inline-flex h-[calc(100%-1px)] flex-1 items-center justify-center whitespace-nowrap transition-all duration-150 group-data-vertical/tabs:w-full group-data-vertical/tabs:justify-start focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-1 focus-visible:outline-none active:scale-[0.97] disabled:pointer-events-none disabled:opacity-50 aria-disabled:pointer-events-none aria-disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0",
"text-foreground/40 hover:text-foreground/70 dark:text-foreground/35 dark:hover:text-foreground/65",
"data-active:bg-foreground data-active:text-background data-active:hover:text-background",
"group-data-[variant=line]/tabs-list:bg-transparent group-data-[variant=line]/tabs-list:text-foreground/45 group-data-[variant=line]/tabs-list:hover:text-foreground group-data-[variant=line]/tabs-list:data-active:bg-transparent group-data-[variant=line]/tabs-list:data-active:font-medium group-data-[variant=line]/tabs-list:data-active:text-foreground",
"after:absolute after:origin-center after:scale-x-0 after:rounded-full after:bg-foreground after:opacity-0 after:transition-[opacity,transform] after:duration-200 group-data-horizontal/tabs:after:inset-x-1 group-data-horizontal/tabs:after:bottom-[-4px] group-data-horizontal/tabs:after:h-[3px] group-data-vertical/tabs:after:inset-y-1 group-data-vertical/tabs:after:-right-1 group-data-vertical/tabs:after:w-[3px] group-data-[variant=line]/tabs-list:data-active:after:scale-x-100 group-data-[variant=line]/tabs-list:data-active:after:opacity-100",
className
)}
{...props}
/>
)
}
function TabsContent({ className, ...props }: TabsPrimitive.Panel.Props) {
const { direction } = React.useContext(TabsCtx)
return (
<TabsPrimitive.Panel
data-slot="tabs-content"
data-direction={direction ?? undefined}
className={cn(
"&[hidden]:!hidden flex-1 outline-none",
className
)}
{...props}
/>
)
}
export { Tabs, TabsList, TabsTrigger, TabsContent, tabsListVariants }
Update the import paths to match your project setup.
Usage#
import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs"<Tabs defaultValue="account" className="w-[400px]">
<TabsList>
<TabsTrigger value="account">Account</TabsTrigger>
<TabsTrigger value="password">Password</TabsTrigger>
</TabsList>
<TabsContent value="account">Make changes to your account here.</TabsContent>
<TabsContent value="password">Change your password here.</TabsContent>
</Tabs>Composition#
Use the following composition to build Tabs:
Tabs
├── TabsList
│ ├── TabsTrigger
│ └── TabsTrigger
├── TabsContent
└── TabsContentExamples#
Line#
Use the variant="line" prop on TabsList for a line style.
import { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs"
export function TabsLine() {Vertical#
Use orientation="vertical" for vertical tabs.
import { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs"
export function TabsVertical() {Disabled#
import { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs"
export function TabsDisabled() {Icons#
import { AppWindowIcon, CodeIcon } from "lucide-react"
import { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs"RTL#
To enable RTL support in shadcn/ui, see the RTL configuration guide.
نظرة عامة
عرض مقاييسك الرئيسية وأنشطة المشروع الأخيرة. تتبع التقدم عبر جميع مشاريعك النشطة.
لديك ١٢ مشروعًا نشطًا و٣ مهام معلقة.
"use client"
import * as React from "react"API Reference#
See the Base UI Tabs documentation.