پرش به محتوا

تغییر وضعیت

یک دکمهٔ دوحالته‌ی روشن/خاموش برای قالب‌بندی نوار ابزار، بی‌صدا کردن و پین کردن کنترل‌ها — با جلوه‌ی نئوبروتالیستی مرزها و سایه‌ها.

import { BookmarkIcon } from "lucide-react"

import { Toggle } from "@/components/ui/toggle"

Toggle یک دکمهٔ دوحالته است — pressed یا نه — که وضعیت on را تا کلیک دوباره نمایان نگه می‌دارد. بر پایهٔ Base UI Toggle ساخته شده و با دستور پخت نئوبروتالیستی استایل شده: حاشیه‌های ضخیم، سایه‌های سخت و تایپوگرافی پررنگ.

برای این موارد از آن استفاده کنید:

  • قالب‌بندی ویرایشگر — دکمه‌های bold، italic، underline در نوار ابزار ویرایشگر متن.
  • اقدام تکی on/off — mute، favorite، pin، follow؛ وضعیت pressed همان نشانگر وضعیت است.
  • گزینه‌های نما — نمایش شبکه، wrap خطوط، split view؛ چندتایشان را در Toggle Group گروه کنید.

نصب

pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/toggle.json
npx shadcn@latest add https://neobrutalism.com/r/base/toggle.json
yarn dlx shadcn@latest add https://neobrutalism.com/r/base/toggle.json
bunx --bun shadcn@latest add https://neobrutalism.com/r/base/toggle.json

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

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

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

components/ui/toggle.tsx
"use client"

import * as React from "react"
import { cva, type VariantProps } from "class-variance-authority"
import { Toggle as TogglePrimitive } from "radix-ui"

import { cn } from "@/lib/utils"

const toggleVariants = cva(
  "group/toggle inline-flex items-center justify-center gap-1 rounded border-2 text-sm font-head font-medium whitespace-nowrap shadow-sm transition-all outline-none hover:bg-accent hover:text-accent-foreground hover:translate-y-0.5 active:translate-y-1 active:shadow-none focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-pressed:bg-primary aria-pressed:text-primary-foreground data-[state=on]:bg-primary data-[state=on]:text-primary-foreground [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
  {
    variants: {
      variant: {
        default: "bg-background",
        outline: "bg-background",
      },
      size: {
        default:
          "h-8 min-w-8 px-2.5 has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2",
        sm: "h-7 min-w-7 rounded-[min(var(--radius-md),12px)] px-2.5 text-[0.8rem] has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 [&_svg:not([class*='size-'])]:size-3.5",
        lg: "h-9 min-w-9 px-2.5 has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2",
      },
    },
    defaultVariants: {
      variant: "default",
      size: "default",
    },
  }
)

function Toggle({
  className,
  variant = "default",
  size = "default",
  ...props
}: React.ComponentProps<typeof TogglePrimitive.Root> &
  VariantProps<typeof toggleVariants>) {
  return (
    <TogglePrimitive.Root
      data-slot="toggle"
      className={cn(toggleVariants({ variant, size, className }))}
      {...props}
    />
  )
}

export { Toggle, toggleVariants }

مسیرهای ایمپورت را مطابق با تنظیمات پروژهٔ خود به‌روزرسانی کنید.

استفاده

import { Toggle } from "@/components/ui/toggle"
<Toggle>Toggle</Toggle>

نمونه‌ها

Outline

برای سبک دارای خط دور از variant="outline" استفاده کنید.

import { BoldIcon, ItalicIcon } from "lucide-react"

import { Toggle } from "@/components/ui/toggle"

با متن

import { ItalicIcon } from "lucide-react"

import { Toggle } from "@/components/ui/toggle"

اندازه

برای تغییر اندازهٔ تاگل از پراپ size استفاده کنید.

import { Toggle } from "@/components/ui/toggle"

export function ToggleSizes() {

غیرفعال

import { Toggle } from "@/components/ui/toggle"

export function ToggleDisabled() {

RTL

برای فعال‌کردن پشتیبانی از RTL در Neobrutalism، راهنمای پیکربندی RTL را ببینید.

"use client"

import * as React from "react"

دسترسی‌پذیری

Toggle از variant دکمهٔ toggle در الگوی WAI-ARIA Button پیروی می‌کند: یک <button> بومی با aria-pressed منعکس‌کنندهٔ وضعیت فعلی رندر می‌کند تا صفحه‌خوان آن را «pressed» یا «not pressed» اعلام کند. مطمئن شوید toggleهای فقط‌آیکون aria-label دارند.

تعاملات صفحه‌کلید:

کلیدعمل
Tab / Shift + Tabانتقال فوکوس به / از toggle
Space / Entertoggle وضعیت pressed

مرجع API

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