تغییر وضعیت
یک دکمهٔ دوحالتهی روشن/خاموش برای قالببندی نوار ابزار، بیصدا کردن و پین کردن کنترلها — با جلوهی نئوبروتالیستی مرزها و سایهها.
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.jsonnpx shadcn@latest add https://neobrutalism.com/r/base/toggle.jsonyarn dlx shadcn@latest add https://neobrutalism.com/r/base/toggle.jsonbunx --bun shadcn@latest add https://neobrutalism.com/r/base/toggle.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 { 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 / Enter | toggle وضعیت pressed |
مرجع API#
مستندات Base UI Toggle را ببینید.