Components/Toggle

Toggle

눌림/해제 상태를 전환하는 토글 버튼입니다. Radix UI Toggle 기반.

Installation

bash
npx axis-cli add toggle

Usage

tsx
import { Toggle } from '@axis-ds/ui-react'

export function Example() {
  return <Toggle aria-label="Toggle bold">B</Toggle>
}

Outline

tsx
<Toggle variant="outline" aria-label="Toggle italic">
  I
</Toggle>

Props

pressed
Type:boolean
Default:-

눌림 상태 (controlled)

defaultPressed
Type:boolean
Default:false

기본 눌림 상태

onPressedChange
Type:(pressed: boolean) => void
Default:-

상태 변경 콜백

variant
Type:"default" | "outline"
Default:"default"

토글 스타일 변형

size
Type:"default" | "sm" | "lg"
Default:"default"

토글 크기

disabled
Type:boolean
Default:false

비활성화 여부

Accessibility

Radix UI Toggle 기반으로 aria-pressed로 눌림 상태를 표현합니다.

KeyAction
Space / Enter눌림 상태를 토글합니다.
  • 아이콘 전용 토글은 aria-label로 의미를 제공하세요.