reopt designreopt design
DocsExploreToolsPricingBuilder
Start
Overview
Start
Next.js 설치
Private install
Core Concepts
아키텍처
Composition Patterns
Accessibility
Keyboard Patterns
Styling
Theme System
Advanced Patterns
Build & Operate
Skills
AI Integration
CLI (opt surface add)
Dependency Graph
Tools
Canvas Catalog
Theme Builder
Form Builder
Templates
Templates
Releases
Release Notes
Oopt-ui
reopt designreopt design

A design system for the AI era

  • Docs
  • Pricing
  • Releases
  • GitHub
  • Terms of Service
  • Privacy Policy

© 2026 reopt-ai. All rights reserved.

Toggle

core

눌림(pressed) 두 상태 버튼. 단독 사용하거나 ToggleGroup으로 묶어 단일/다중 선택을 만든다.

100%

단독 Toggle

상태: 꺼짐

단일 선택 그룹 (정렬)

선택: left

다중 선택 그룹 (서식)

선택: bold

테스트 커버리지

2026년 2월 4일

생성된 테스트 결과를 찾지 못했습니다.

Toggle 항목이 문서 메타에 연결되어 있지만 현재 생성 파일에는 없습니다.

테스트를 추가한 뒤 `bun run generate:test-results`를 실행하거나 `testDescribe` 매핑을 다시 확인하세요.

Toggle Props

Prop타입기본값설명
pressedboolean—제어 모드: 눌림 상태 (단독 사용)
defaultPressedboolean—비제어 초기 눌림 상태 (단독 사용)
onPressedChange(pressed: boolean) => void—눌림 상태 변경 콜백 (단독 사용)
valuestring—ToggleGroup 내에서 이 토글을 식별하는 값
size"sm" | "md"—크기 (기본 md)
disabledboolean—비활성화
childrenReactNode—토글 콘텐츠

ToggleGroup Props

Prop타입기본값설명
valuestring | string[]—선택 값. 단일은 string, toggleMultiple은 string[]
defaultValuestring | string[]—비제어 초기 선택 값
onValueChange(value: string | string[]) => void—선택 변경 콜백
toggleMultipleboolean—동시에 여러 개 눌림 허용
orientation"horizontal" | "vertical"—배치 방향 (기본 horizontal)
disabledboolean—그룹 전체 비활성화
childrenReactNode—Toggle 항목들

Import

tsx
import { Toggle, ToggleGroup } from "@reopt-ai/opt-ui";