קבוצת מתגים
קבוצות כפתורים דו-מצביות עבור סרגלי כלים בעורך, מחליפי תצוגה וסרגלי סינון — עם עיצוב ניאו-ברוטליסטי הכולל מסגרות וצללים.
import { Bold, Italic, Underline } from "lucide-react"
import {ה-toggle group הוא שורה של כפתורים דו-מצביים שבהם אחד (ברירת המחדל) או כמה (multiple) יכולים להיות לחוצים בכל פעם. נבנה על גבי רכיב Base UI Toggle Group ומעוצב לפי המתכון הנאו-ברוטליסטי: מסגרות עבות, צללים חדים וטיפוגרפיה מודגשת.
השתמשו בו כש:
- סרגלי כלי עורך — bold/italic/underline, יישור טקסט, סגנונות רשימה עם
multiple. - מחליפי תצוגה — רשת מול רשימה, תרשים מול טבלה, יום/שבוע/חודש; ברירת המחדל משאירה לכל היותר אחד פעיל.
- סרגלי מסננים — תגיות, קטגוריות או facets שהמשתמשים יכולים להוסיף ולהסיר.
התקנה#
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 כך שיתאימו להגדרות הפרויקט שלכם.
שימוש#
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דוגמאות#
מתאר#
השתמשו ב-variant="outline" לסגנון עם מתאר.
import {
ToggleGroup,
ToggleGroupItem,גודל#
השתמשו ב-prop size כדי לשנות את הגודל של קבוצת הטוגל.
import {
ToggleGroup,
ToggleGroupItem,מרווח#
השתמשו ב-spacing כדי להוסיף מרווח בין הפריטים בקבוצת הטוגל.
import {
ToggleGroup,
ToggleGroupItem,אנכי#
השתמשו ב-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 לפי דפוס Button של WAI-ARIA: הקבוצה מרנדרת role="group" וכל פריט הוא <button> אמיתי עם aria-pressed, גם במצב single וגם ב-multiple. מוקד משתמש ב-roving tabindex, כך שכל הקבוצה היא Tab stop יחיד. פריטי אייקון בלבד צריכים aria-label.
אינטראקציות מקלדת:
| מקש | פעולה |
|---|---|
Tab / Shift + Tab | מעבירים מוקד אל הקבוצה והחוצה |
Space / Enter | מחליפים את הפריט שבפוקוס |
ArrowRight / ArrowDown | מעבירים מוקד לפריט הבא |
ArrowLeft / ArrowUp | מעבירים מוקד לפריט הקודם |
Home / End | קופצים לפריט הראשון / האחרון |
תיעוד ה-API#
למידע נוסף, עיינו בתיעוד של Base UI.
יומן שינויים#
2026-05-17 מרווח ברירת מחדל#
שינינו את ברירת המחדל של spacing מ-0 ל-2, כך שקבוצות טוגל מוצגות כברירת מחדל עם מרווח בין הפריטים. השתמשו ב-spacing={0} לפריטים מחוברים.