콘텐츠로 건너뛰기
1.6k

토글

도구 모음의 서식, 음소거 및 고정 제어 기능을 위한 2단계(켜기/끄기) 버튼 — 네오브루탈리즘 스타일의 테두리와 그림자 효과가 적용되었습니다.

import { BookmarkIcon } from "lucide-react"

import { Toggle } from "@/components/ui/toggle"

토글은 눌림/안 눌림 두 상태 버튼으로, 다시 클릭할 때까지 켜진 상태가 보입니다. Base UI Toggle 프리미티브를 기반으로 하며, 네오브루탈리즘 공식(두꺼운 테두리, 선명한 그림자, 굵은 서체)에 맞춰 스타일을 입혔습니다.

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

  • 에디터 서식 — 텍스트 에디터 툴바의 굵게, 기울임, 밑줄 버튼.
  • 단일 켜기/끄기 동작 — 음소거, 즐겨찾기, 고정, 팔로우. 눌린 상태가 곧 상태 표시입니다.
  • 보기 옵션 — 그리드 표시, 줄 바꿈, 분할 보기. 여러 개를 Toggle Group으로 묶습니다.

설치

pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/toggle.json
npx shadcn@latest add https://neobrutalism.com/r/base/toggle.json
yarn dlx shadcn@latest add https://neobrutalism.com/r/base/toggle.json
bunx --bun shadcn@latest add https://neobrutalism.com/r/base/toggle.json

다음 의존성을 설치합니다.

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

다음 코드를 복사하여 프로젝트에 붙여넣습니다.

components/ui/toggle.tsx
"use client"

import * as React from "react"
import { cva, type VariantProps } from "class-variance-authority"
import { Toggle as TogglePrimitive } from "radix-ui"

import { cn } from "@/lib/utils"

const toggleVariants = cva(
  "group/toggle inline-flex items-center justify-center gap-1 rounded border-2 text-sm font-head font-medium whitespace-nowrap shadow-sm transition-all outline-none hover:bg-accent hover:text-accent-foreground hover:translate-y-0.5 active:translate-y-1 active:shadow-none focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-pressed:bg-primary aria-pressed:text-primary-foreground data-[state=on]:bg-primary data-[state=on]:text-primary-foreground [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
  {
    variants: {
      variant: {
        default: "bg-background",
        outline: "bg-background",
      },
      size: {
        default:
          "h-8 min-w-8 px-2.5 has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2",
        sm: "h-7 min-w-7 rounded-[min(var(--radius-md),12px)] px-2.5 text-[0.8rem] has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 [&_svg:not([class*='size-'])]:size-3.5",
        lg: "h-9 min-w-9 px-2.5 has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2",
      },
    },
    defaultVariants: {
      variant: "default",
      size: "default",
    },
  }
)

function Toggle({
  className,
  variant = "default",
  size = "default",
  ...props
}: React.ComponentProps<typeof TogglePrimitive.Root> &
  VariantProps<typeof toggleVariants>) {
  return (
    <TogglePrimitive.Root
      data-slot="toggle"
      className={cn(toggleVariants({ variant, size, className }))}
      {...props}
    />
  )
}

export { Toggle, toggleVariants }

임포트 경로를 프로젝트 구성에 맞게 조정합니다.

사용법

import { Toggle } from "@/components/ui/toggle"
<Toggle>Toggle</Toggle>

예제

아웃라인

아웃라인 스타일로 표시하려면 variant="outline"을 지정합니다.

import { BoldIcon, ItalicIcon } from "lucide-react"

import { Toggle } from "@/components/ui/toggle"

텍스트 포함

import { ItalicIcon } from "lucide-react"

import { Toggle } from "@/components/ui/toggle"

크기

size prop을 사용하여 토글의 크기를 변경합니다.

import { Toggle } from "@/components/ui/toggle"

export function ToggleSizes() {

비활성화

import { Toggle } from "@/components/ui/toggle"

export function ToggleDisabled() {

RTL

Neobrutalism에서 RTL 지원을 활성화하는 방법은 RTL 설정 가이드를 참고하세요.

"use client"

import * as React from "react"

접근성

토글은 WAI-ARIA Button 패턴의 토글 버튼 변형을 따릅니다. 현재 상태를 반영하는 aria-pressed가 있는 네이티브 <button>을 렌더링하므로 스크린 리더가 "pressed" 또는 "not pressed"로 읽습니다. 아이콘만 있는 토글에는 aria-label을 두세요.

키보드 상호작용:

키동작
Tab / Shift + Tab토글로 포커스 이동/이탈
Space / Enter눌림 상태 전환

API 참조

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