پرش به محتوا

سوییچ

یک کلید روشن/خاموش برای تنظیمات فوری — اعلان‌ها، حالت تاریک، پرچم‌های ویژگی — با جلوه‌ی نئوبروتالیستی مرزها و سایه‌ها.

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.json
npx shadcn@latest add https://neobrutalism.com/r/base/switch.json
yarn dlx shadcn@latest add https://neobrutalism.com/r/base/switch.json
bunx --bun shadcn@latest add https://neobrutalism.com/r/base/switch.json

وابستگی‌های زیر را نصب کنید:

pnpm add @base-ui/react
npm install @base-ui/react
yarn add @base-ui/react
bun add @base-ui/react

کد زیر را کپی کرده و در پروژهٔ خود بچسبانید.

components/ui/switch.tsx
"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
Spacetoggle switch
Entertoggle switch

مرجع API

مستندات Base UI Switch را ببینید.