گروه تغییر وضعیت
گروههای دکمهای دوحالت برای نوار ابزار ویرایشگر، جابهزنهای نما و نوارهای فیلتر — با جلوهی نئوبروتالیستی حاشیهها و سایهها.
import { Bold, Italic, Underline } from "lucide-react"
import {گروه toggle ردیفی از دکمههای دوحالته است که یکی (پیشفرض) یا چندتا (multiple) میتوانند همزمان pressed باشند. بر پایهٔ Base UI Toggle Group ساخته شده و با دستور پخت نئوبروتالیستی استایل شده: حاشیههای ضخیم، سایههای سخت و تایپوگرافی پررنگ.
برای این موارد از آن استفاده کنید:
- نوار ابزار ویرایشگر — bold/italic/underline، تراز متن، استایل فهرست با
multiple. - سوئیچر نما — شبکه در برابر فهرست، نمودار در برابر جدول، روز/هفته/ماه؛ پیشفرض حداکثر یکی را فعال نگه میدارد.
- نوار فیلتر — تگ، دسته یا facet که کاربر میتواند روی هم روشن/خاموش کند.
نصب#
pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/toggle-group.jsonnpx shadcn@latest add https://neobrutalism.com/r/base/toggle-group.jsonyarn dlx shadcn@latest add https://neobrutalism.com/r/base/toggle-group.jsonbunx --bun shadcn@latest add https://neobrutalism.com/r/base/toggle-group.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 { type VariantProps } from "class-variance-authority"
import { ToggleGroup as ToggleGroupPrimitive } from "radix-ui"
import { cn } from "@/lib/utils"
import { toggleVariants } from "@/components/ui/toggle"
const ToggleGroupContext = React.createContext<
VariantProps<typeof toggleVariants> & {
spacing?: number
orientation?: "horizontal" | "vertical"
}
>({
size: "default",
variant: "default",
spacing: 2,
orientation: "horizontal",
})
function ToggleGroup({
className,
variant,
size,
spacing = 2,
orientation = "horizontal",
children,
...props
}: React.ComponentProps<typeof ToggleGroupPrimitive.Root> &
VariantProps<typeof toggleVariants> & {
spacing?: number
orientation?: "horizontal" | "vertical"
}) {
return (
<ToggleGroupPrimitive.Root
data-slot="toggle-group"
data-variant={variant}
data-size={size}
data-spacing={spacing}
data-orientation={orientation}
style={{ "--gap": spacing } as React.CSSProperties}
className={cn(
"group/toggle-group flex w-fit flex-row items-center gap-[--spacing(var(--gap))] rounded-lg data-[size=sm]:rounded-[min(var(--radius-md),10px)] data-vertical:flex-col data-vertical:items-stretch",
className
)}
{...props}
>
<ToggleGroupContext.Provider
value={{ variant, size, spacing, orientation }}
>
{children}
</ToggleGroupContext.Provider>
</ToggleGroupPrimitive.Root>
)
}
function ToggleGroupItem({
className,
children,
variant = "default",
size = "default",
...props
}: React.ComponentProps<typeof ToggleGroupPrimitive.Item> &
VariantProps<typeof toggleVariants>) {
const context = React.useContext(ToggleGroupContext)
return (
<ToggleGroupPrimitive.Item
data-slot="toggle-group-item"
data-variant={context.variant || variant}
data-size={context.size || size}
data-spacing={context.spacing}
className={cn(
"shrink-0 group-data-[spacing=0]/toggle-group:rounded-none group-data-[spacing=0]/toggle-group:px-2 focus:z-10 focus-visible:z-10 group-data-[spacing=0]/toggle-group:has-data-[icon=inline-end]:pr-1.5 group-data-[spacing=0]/toggle-group:has-data-[icon=inline-start]:pl-1.5 group-data-horizontal/toggle-group:data-[spacing=0]:first:rounded-l-lg group-data-vertical/toggle-group:data-[spacing=0]:first:rounded-t-lg group-data-horizontal/toggle-group:data-[spacing=0]:last:rounded-r-lg group-data-vertical/toggle-group:data-[spacing=0]:last:rounded-b-lg group-data-horizontal/toggle-group:data-[spacing=0]:data-[variant=outline]:border-l-0 group-data-vertical/toggle-group:data-[spacing=0]:data-[variant=outline]:border-t-0 group-data-horizontal/toggle-group:data-[spacing=0]:data-[variant=outline]:first:border-l group-data-vertical/toggle-group:data-[spacing=0]:data-[variant=outline]:first:border-t",
toggleVariants({
variant: context.variant || variant,
size: context.size || size,
}),
className
)}
{...props}
>
{children}
</ToggleGroupPrimitive.Item>
)
}
export { ToggleGroup, ToggleGroupItem }
مسیرهای ایمپورت را مطابق با تنظیمات پروژهٔ خود بهروزرسانی کنید.
استفاده#
import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group"<ToggleGroup type="single">
<ToggleGroupItem value="a">A</ToggleGroupItem>
<ToggleGroupItem value="b">B</ToggleGroupItem>
<ToggleGroupItem value="c">C</ToggleGroupItem>
</ToggleGroup>ترکیب#
برای ساخت یک ToggleGroup از ترکیب زیر استفاده کنید:
ToggleGroup
├── ToggleGroupItem
└── ToggleGroupItemنمونهها#
Outline#
برای سبک دارای خط دور از variant="outline" استفاده کنید.
import {
ToggleGroup,
ToggleGroupItem,اندازه#
برای تغییر اندازهٔ گروه تاگل از پراپ size استفاده کنید.
import {
ToggleGroup,
ToggleGroupItem,فاصلهگذاری#
برای افزودن فاصله میان آیتمهای گروه تاگل از spacing استفاده کنید.
import {
ToggleGroup,
ToggleGroupItem,Vertical#
برای گروههای تاگل عمودی از orientation="vertical" استفاده کنید.
import { BoldIcon, ItalicIcon, UnderlineIcon } from "lucide-react"
import {غیرفعال#
import { Bold, Italic, Underline } from "lucide-react"
import {سفارشی#
نمونهای از یک گروه تاگل سفارشی.
"use client"
import * as React from "react"RTL#
برای فعالکردن پشتیبانی از RTL در Neobrutalism، راهنمای پیکربندی RTL را ببینید.
"use client"
import * as React from "react"دسترسیپذیری#
هر آیتم دکمهٔ toggle مطابق الگوی WAI-ARIA Button است: گروه role="group" رندر میکند و هر آیتم <button> واقعی با aria-pressed است، در هر دو حالت single و multiple. فوکوس از roving tabindex استفاده میکند تا کل گروه یک Tab stop باشد. آیتمهای فقطآیکون به aria-label نیاز دارند.
تعاملات صفحهکلید:
| کلید | عمل |
|---|---|
Tab / Shift + Tab | ورود فوکوس به گروه و خروج |
Space / Enter | toggle آیتم فوکوسشده |
ArrowRight / ArrowDown | انتقال فوکوس به آیتم بعدی |
ArrowLeft / ArrowUp | انتقال فوکوس به آیتم قبلی |
Home / End | پرش به اولین / آخرین آیتم |
مرجع API#
مستندات Base UI Toggle Group را ببینید.
تاریخچهٔ تغییرات#
2026-05-17 فاصلهگذاری پیشفرض#
مقدار پیشفرض spacing از 0 به 2 تغییر یافت تا گروههای تاگل اکنون بهطور پیشفرض با فاصله میان آیتمها نمایش داده شوند. برای آیتمهای متصل از spacing={0} استفاده کنید.