跳到内容
1.6k

切换组

适用于编辑器工具栏、视图切换器和过滤栏的双状态按钮组——采用新粗野主义风格的边框与阴影处理效果。

import { Bold, Italic, Underline } from "lucide-react"

import {

切换按钮组是一排双状态按钮，同一时刻可以按下其中一个（默认行为），也可以按下多个（multiple）。它基于 Base UI Toggle Group 组件构建，并按新粗野主义的配方设计：粗边框、硬阴影、加粗字体。

适合以下场景：

  • 编辑器工具栏——加粗/斜体/下划线、文本对齐、列表样式，配合 multiple 使用。
  • 视图切换器——网格与列表、图表与表格、日/周/月；默认行为下最多只有一个处于激活状态。
  • 筛选栏——标签、分类或分面条件，用户可以随意叠加与取消。

安装

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

示例

描边

描边样式请使用 variant="outline"。

import {
  ToggleGroup,
  ToggleGroupItem,

尺寸

使用 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

要在 Neobrutalism 中启用 RTL 支持，请参阅 RTL 配置指南。

"use client"

import * as React from "react"

无障碍

每一项都是符合 WAI-ARIA Button 模式 的切换按钮：组渲染为 role="group"，而无论单选还是多选模式，每一项都是带 aria-pressed 的真正 <button>。焦点采用 roving tabindex，因此整个组只占一个 Tab 停靠位。纯图标的项需要 aria-label。

键盘交互：

按键操作
Tab / Shift + Tab把焦点移入组内或移出
Space / Enter切换当前聚焦项
ArrowRight / ArrowDown把焦点移到下一项
ArrowLeft / ArrowUp把焦点移到上一项
Home / End跳到第一项或最后一项

API 参考

请参阅 Base UI Toggle Group 文档。

更新日志

2026-05-17 默认间距

将默认的 spacing 从 0 改为 2，使切换按钮组默认在各项之间留出间距。若要连接各项，请使用 spacing={0}。