مفتاح تبديل
مفتاح تشغيل/إيقاف للإعدادات الفورية — الإشعارات، والوضع المظلم، وعلامات الميزات — مع تصميم «النيوبروتاليستي» الذي يتميز بالحدود والظلال.
import { Label } from "@/components/ui/label"
import { Switch } from "@/components/ui/switch"
المفتاح عبارة عن مفتاح تبديل ثنائي الحالة — تشغيل أو إيقاف — يتم تطبيقه فور قلبه، ولا يوجد زر «إرسال». تم بناؤه باستخدام مكون Base UI Switch وتصميمه وفقًا لأسلوب «النيوبروتالية»: حدود سميكة، وظلال حادة، وخط عريض.
استخدمه عندما:
- لوحات الإعدادات — الإشعارات، الوضع المظلم، التشغيل التلقائي: التفضيلات التي تدخل حيز التنفيذ فورًا.
- علامات الميزات — تمكين ميزة تجريبية أو التبديل بين الفوترة الشهرية والسنوية.
- عناصر التحكم لكل صف — تنشيط العناصر أو إيقافها مؤقتًا في جدول أو قائمة دون فتح نموذج.
التثبيت#
pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/switch.jsonnpx shadcn@latest add https://neobrutalism.com/r/base/switch.jsonyarn dlx shadcn@latest add https://neobrutalism.com/r/base/switch.jsonbunx --bun shadcn@latest add https://neobrutalism.com/r/base/switch.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 { Switch as SwitchPrimitive } from "radix-ui"
import { cn } from "@/lib/utils"
function Switch({
className,
size = "default",
...props
}: React.ComponentProps<typeof SwitchPrimitive.Root> & {
size?: "sm" | "default"
}) {
return (
<SwitchPrimitive.Root
data-slot="switch"
data-size={size}
className={cn(
"peer group/switch relative inline-flex shrink-0 cursor-pointer items-center border-2 border-foreground transition-all outline-none after:absolute after:-inset-x-3 after:-inset-y-2 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary aria-invalid:border-destructive data-[size=default]:h-6 data-[size=default]:w-11 data-[size=sm]:h-5 data-[size=sm]:w-9 data-checked:bg-primary data-disabled:cursor-not-allowed data-disabled:opacity-50",
className
)}
{...props}
>
<SwitchPrimitive.Thumb
data-slot="switch-thumb"
className="pointer-events-none mx-0.5 block border-2 border-foreground bg-primary transition-transform group-data-[size=default]/switch:size-4 group-data-[size=sm]/switch:size-3 group-data-[size=default]/switch:data-checked:translate-x-5 group-data-[size=sm]/switch:data-checked:translate-x-4 data-checked:bg-background data-unchecked:translate-x-0"
/>
</SwitchPrimitive.Root>
)
}
export { Switch }
حدّث مسارات الاستيراد لتطابق إعداد مشروعك.
الاستخدام#
import { Switch } from "@/components/ui/switch"<Switch />أمثلة#
الوصف#
import {
Field,
FieldContent,بطاقة الاختيار#
اختيار بنمط البطاقة، حيث يلفّ FieldLabel كامل Field لإنشاء نمط بطاقة قابلة للنقر.
import {
Field,
FieldContent,معطّل#
أضف الخاصية disabled إلى مكوّن Switch لتعطيل المُبدِّل. أضف الخاصية data-disabled إلى مكوّن Field لأغراض التنسيق.
import { Field, FieldLabel } from "@/components/ui/field"
import { Switch } from "@/components/ui/switch"
غير صالح#
أضف الخاصية aria-invalid إلى مكوّن Switch للإشارة إلى حالة غير صالحة. أضف الخاصية data-invalid إلى مكوّن Field لأغراض التنسيق.
import {
Field,
FieldContent,الحجم#
استخدم الخاصية size لتغيير حجم المُبدِّل.
import { Field, FieldGroup, FieldLabel } from "@/components/ui/field"
import { Switch } from "@/components/ui/switch"
RTL#
لتفعيل RTL في Neobrutalism، راجع دليل إعداد RTL.
"use client"
import * as React from "react"إمكانية الوصول#
يتبع هذا المفتاح نمط WAI-ARIA Switch pattern: فهو يعرض زرًا حقيقيًّا مع role="switch" وaria-checked، بالإضافة إلى حقل إدخال مخفي بحيث يتم إرسال القيمة مع النموذج المحيط به.
تفاعلات لوحة المفاتيح:
| المفتاح | الإجراء |
|---|---|
Tab / Shift + Tab | تحريك التركيز إلى/بعيدًا عن المفتاح |
Space | تبديل حالة المفتاح |
Enter | تبديل حالة المفتاح |
مرجع API#
لمزيد من المعلومات، راجع وثائق Base UI.