پرش به محتوا

گروه تغییر وضعیت

گروه‌های دکمه‌ای دوحالت برای نوار ابزار ویرایشگر، جابه‌زن‌های نما و نوارهای فیلتر — با جلوه‌ی نئوبروتالیستی حاشیه‌ها و سایه‌ها.

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

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

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

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

components/ui/toggle-group.tsx
"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 / Entertoggle آیتم فوکوس‌شده
ArrowRight / ArrowDownانتقال فوکوس به آیتم بعدی
ArrowLeft / ArrowUpانتقال فوکوس به آیتم قبلی
Home / Endپرش به اولین / آخرین آیتم

مرجع API

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

تاریخچهٔ تغییرات

2026-05-17 فاصله‌گذاری پیش‌فرض

مقدار پیش‌فرض spacing از 0 به 2 تغییر یافت تا گروه‌های تاگل اکنون به‌طور پیش‌فرض با فاصله میان آیتم‌ها نمایش داده شوند. برای آیتم‌های متصل از spacing={0} استفاده کنید.