علامات تبويب
يمكنك التبديل بين لوحات المحتوى المتراكبة — صفحات الإعدادات، ولوحات المعلومات، ومعاينات الأكواد — مع تصميم «النيوبروتاليستي» الذي يتميز بالحدود والظلال.
import {
Card,
CardContent,تنظم علامات التبويب لوحات المحتوى المتراكبة خلف صف من عناصر التشغيل — حيث تظهر لوحة واحدة في كل مرة، دون الحاجة إلى التنقل. وهي مبنية على مكون Base UI Tabs ومصممة وفقًا لأسلوب «النيوبروتالية»: حدود سميكة، وظلال حادة، وخط عريض.
استخدمه عندما:
- صفحات الإعدادات — الحساب / كلمة المرور / الإشعارات في شاشة واحدة، مع الحفاظ على الحالة عند التبديل.
- طرق عرض لوحة التحكم — التبديل بين «النظرة العامة» و«التحليلات» و«التقارير» دون تغيير المسار.
- أجزاء «الكود + المعاينة» — عنصر أساسي في مواقع الوثائق: أزرار التبديل بين «المعاينة» و«الكود» وأوامر التثبيت لكل مدير حزم.
التثبيت#
pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/tabs.jsonnpx shadcn@latest add https://neobrutalism.com/r/base/tabs.jsonyarn dlx shadcn@latest add https://neobrutalism.com/r/base/tabs.jsonbunx --bun shadcn@latest add https://neobrutalism.com/r/base/tabs.json
ثبّت التبعيات التالية:
pnpm add @base-ui/reactnpm install @base-ui/reactyarn add @base-ui/reactbun add @base-ui/react
انسخ الكود التالي والصقه في مشروعك.
"use client"
import * as React from "react"
import { cva, type VariantProps } from "class-variance-authority"
import { Tabs as TabsPrimitive } from "radix-ui"
import { cn } from "@/lib/utils"
function Tabs({
className,
orientation = "horizontal",
...props
}: React.ComponentProps<typeof TabsPrimitive.Root>) {
return (
<TabsPrimitive.Root
data-slot="tabs"
data-orientation={orientation}
className={cn(
"group/tabs flex gap-2 data-horizontal:flex-col",
className
)}
{...props}
/>
)
}
const tabsListVariants = cva(
"group/tabs-list inline-flex w-fit items-center justify-center rounded p-1 text-muted-foreground group-data-horizontal/tabs:h-11 group-data-vertical/tabs:h-fit group-data-vertical/tabs:flex-col data-[variant=line]:rounded-none",
{
variants: {
variant: {
default: "border-2 bg-card shadow-sm",
line: "gap-1 bg-transparent",
},
},
defaultVariants: {
variant: "default",
},
}
)
function TabsList({
className,
variant = "default",
...props
}: React.ComponentProps<typeof TabsPrimitive.List> &
VariantProps<typeof tabsListVariants>) {
return (
<TabsPrimitive.List
data-slot="tabs-list"
data-variant={variant}
className={cn(tabsListVariants({ variant }), className)}
{...props}
/>
)
}
function TabsTrigger({
className,
...props
}: React.ComponentProps<typeof TabsPrimitive.Trigger>) {
return (
<TabsPrimitive.Trigger
data-slot="tabs-trigger"
className={cn(
"relative inline-flex h-[calc(100%-1px)] flex-1 cursor-pointer items-center justify-center gap-1.5 rounded border-2 border-transparent px-4 py-2 text-sm font-head font-medium whitespace-nowrap text-foreground/60 transition-all group-data-vertical/tabs:w-full group-data-vertical/tabs:justify-start hover:text-foreground focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary disabled:pointer-events-none disabled:opacity-50 has-data-[icon=inline-end]:pr-1 has-data-[icon=inline-start]:pl-1 group-data-[variant=default]/tabs-list:data-active:border-border group-data-[variant=default]/tabs-list:data-active:shadow-sm group-data-[variant=line]/tabs-list:data-active:shadow-none [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
"group-data-[variant=line]/tabs-list:bg-transparent group-data-[variant=line]/tabs-list:data-active:bg-transparent",
"data-active:bg-primary data-active:text-primary-foreground group-data-[variant=line]/tabs-list:data-active:text-foreground",
"after:absolute after:bg-foreground after:opacity-0 after:transition-opacity group-data-horizontal/tabs:after:inset-x-0 group-data-horizontal/tabs:after:bottom-[-5px] group-data-horizontal/tabs:after:h-1 group-data-vertical/tabs:after:inset-y-0 group-data-vertical/tabs:after:-right-1 group-data-vertical/tabs:after:w-1 group-data-[variant=line]/tabs-list:data-active:after:opacity-100",
className
)}
{...props}
/>
)
}
function TabsContent({
className,
...props
}: React.ComponentProps<typeof TabsPrimitive.Content>) {
return (
<TabsPrimitive.Content
data-slot="tabs-content"
className={cn("flex-1 text-sm outline-none", className)}
{...props}
/>
)
}
export { Tabs, TabsList, TabsTrigger, TabsContent, tabsListVariants }
حدّث مسارات الاستيراد لتطابق إعداد مشروعك.
الاستخدام#
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>التركيب#
استخدم التركيب التالي لبناء Tabs:
Tabs
├── TabsList
│ ├── TabsTrigger
│ └── TabsTrigger
├── TabsContent
└── TabsContentأمثلة#
خط#
استخدم الخاصية variant="line" على TabsList للحصول على نمط خطّي.
import { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs"
export function TabsLine() {عمودي#
استخدم orientation="vertical" للتبويبات العمودية.
import { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs"
export function TabsVertical() {معطّل#
import { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs"
export function TabsDisabled() {أيقونات#
import { AppWindowIcon, CodeIcon } from "lucide-react"
import { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs"RTL#
لتفعيل RTL في Neobrutalism، راجع دليل إعداد RTL.
"use client"
import * as React from "react"إمكانية الوصول#
تتبع علامات التبويب WAI-ARIA Tabs pattern: تُعرض القائمة على شكل role="tablist"، وكل زر تشغيل هو زر role="tab" مع aria-selected وaria-controls، وكل لوحة هي role="tabpanel" مُسمَّاة باسم زر التشغيل الخاص بها. يظهر المشغل النشط فقط في ترتيب علامات التبويب — بينما تتولى مفاتيح الأسهم الباقي (مؤشر التبويب المتنقل). بشكل افتراضي، يؤدي التركيز على المشغل إلى تنشيطه أيضًا؛ قم بتعيين activateOnFocus={false} على TabsList لطلب Space/Enter صريح.
تفاعلات لوحة المفاتيح:
| المفتاح | الإجراء |
|---|---|
Tab | نقل التركيز إلى المشغل النشط، ثم إلى اللوحة النشطة |
ArrowRight / ArrowLeft | نقل التركيز إلى المشغل التالي / السابق (الاتجاه الأفقي) |
ArrowDown / ArrowUp | نقل التركيز إلى المشغل التالي / السابق (الاتجاه الرأسي) |
Home / End | الانتقال إلى المشغل الأول / الأخير |
Space / Enter | تنشيط المشغل الذي تم التركيز عليه (مطلوب فقط مع التنشيط اليدوي) |
مرجع API#
لمزيد من المعلومات، راجع وثائق Base UI.