سوییچ
یک کلید روشن/خاموش برای تنظیمات فوری — اعلانها، حالت تاریک، پرچمهای ویژگی — با جلوهی نئوبروتالیستی مرزها و سایهها.
import { Label } from "@/components/ui/label"
import { Switch } from "@/components/ui/switch"
Switch یک toggle دوحالته است — روشن یا خاموش، همان لحظهٔ flip اعمال میشود، بدون دکمهٔ submit. بر پایهٔ Base UI Switch ساخته شده و با دستور پخت نئوبروتالیستی استایل شده: حاشیههای ضخیم، سایههای سخت و تایپوگرافی پررنگ.
برای این موارد از آن استفاده کنید:
- پنل تنظیمات — اعلان، حالت تاریک، autoplay: ترجیحاتی که فوری اثر میکنند.
- Feature flag — فعالسازی ویژگی beta یا تعویض صورتحساب ماهانه/سالانه.
- کنترل per-row — فعال یا pause کردن آیتم در جدول یا فهرست بدون باز کردن فرم.
نصب#
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"دسترسیپذیری#
Switch از الگوی WAI-ARIA Switch پیروی میکند: یک دکمهٔ واقعی با role="switch" و aria-checked رندر میکند، بهعلاوهٔ یک input پنهان تا مقدار با فرم اطراف submit شود.
تعاملات صفحهکلید:
| کلید | عمل |
|---|---|
Tab / Shift + Tab | انتقال فوکوس به / از switch |
Space | toggle switch |
Enter | toggle switch |
مرجع API#
مستندات Base UI Switch را ببینید.