콘텐츠로 건너뛰기
1.6k

토글 그룹

에디터 툴바, 뷰 전환기, 필터 바를 위한 2상태 버튼 그룹 — 네오브루탈리즘 스타일의 테두리와 그림자 효과를 적용했습니다.

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

import {

토글 그룹은 한 번에 하나(기본) 또는 여러 개(multiple)가 눌릴 수 있는 두 상태 버튼 행입니다. Base UI Toggle Group 컴포넌트를 기반으로 하며, 네오브루탈리즘 공식(두꺼운 테두리, 선명한 그림자, 굵은 서체)에 맞춰 스타일을 입혔습니다.

다음과 같은 경우에 사용합니다.

  • 에디터 툴바 — multiple로 굵게/기울임/밑줄, 정렬, 목록 스타일.
  • 보기 전환 — 그리드 vs 목록, 차트 vs 테이블, 일/주/월. 기본값은 최대 하나만 활성입니다.
  • 필터 바 — 사용자가 켜고 끌 수 있는 태그, 카테고리, 패싯.

설치

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 prop을 사용하여 토글 그룹의 크기를 변경합니다.

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>입니다. 포커스는 로빙 tabindex를 쓰므로 그룹 전체가 Tab 스톱 하나입니다. 아이콘만 있는 항목에는 aria-label이 필요합니다.

키보드 상호작용:

키동작
Tab / Shift + Tab그룹으로 포커스 이동/이탈
Space / Enter포커스된 항목 전환
ArrowRight / ArrowDown다음 항목으로 포커스 이동
ArrowLeft / ArrowUp이전 항목으로 포커스 이동
Home / End첫/마지막 항목으로 이동

API 참조

Base UI Toggle Group 문서를 참고하세요.

변경 로그

2026-05-17 Default Spacing

기본 spacing을 0에서 2로 변경하여 토글 그룹이 기본적으로 항목 사이에 간격을 두고 표시되도록 했습니다. 항목을 연결하려면 spacing={0}을 사용합니다.