reopt design
DocsExploreTemplatesCanvasToolsPricing
Login
opt-uiopt-chartsopt-datagridopt-editoropt-calendaropt-filemanageropt-chatopt-shellbrandapp-ui
Overview205Core74Shells99Blocks32
RadioGroup
reopt designreopt design

A design system for the AI era

  • Docs
  • Pricing
  • Releases
  • About
  • Contact
  • Terms of Service
  • Privacy Policy

reopt Inc.Business registration no. 217-88-02453contact@reopt.ai

© 2026 reopt Inc. All rights reserved.

RadioGroup

Component

Choose one option with separate group and item descriptions and multiple sizes.

input
Related docs
bun add @reopt-ai/opt-ui
Install and import
bash
bun add @reopt-ai/opt-ui
tsx
import { RadioGroup, Radio } from "@reopt-ai/opt-ui";

Live preview

Change the width and theme, then interact with the components.

100%

Basic

요금제 선택

Sizes

Small
Medium
Large

Horizontal Layout

배송 방법

Disabled

플랜 선택 (비활성화)

Without Group Label

RadioGroup

PropTypeDefaultDescription
valuestring—제어 모드: 선택된 값
defaultValuestring""비제어 모드: 초기 선택 값
onChange(value: string) => void—선택 변경 핸들러
orientation"horizontal" | "vertical""vertical"레이아웃 방향
labelstring—그룹 레이블
namestring—폼 제출 시 사용할 이름

Radio

PropTypeDefaultDescription
valuestring—라디오 값 (RadioGroup 안에서는 부모가 관리하므로 optional)
labelstring—라디오 레이블
hintstring—레이블 아래 보조 설명 텍스트
descriptionstring—레이블 아래 설명 텍스트
size"sm" | "md" | "lg""md"라디오 크기

컴포넌트 의존 관계

깊이
▲ USED BY (2)settings-formform-wizardRadioGroup
View test results

테스트 커버리지

2026년 7월 9일9/9 통과
9성공
0실패
9전체
  • label을 렌더링한다
  • visible label을 radiogroup accessible name으로 연결한다
  • 라디오 버튼들을 렌더링한다
  • 클릭 시 선택이 변경된다
  • disabled 상태를 지원한다
  • horizontal orientation을 지원한다
  • error 메시지를 표시한다
  • error 메시지를 aria-describedby로 연결한다
  • required prop이 RequiredMark를 표시한다

키보드 동작

키동작
↑ ↓라디오 옵션 간 탐색
← →라디오 옵션 간 탐색
Space현재 옵션 선택

Related components

opt-ui

Select

Core

Build a dropdown selection with Root, Label, Trigger, Popover, and Item components.

opt-ui

Combobox

Core

Build autocomplete search with an input, popover, items, groups, group labels, and an empty state.

opt-ui

Button

Core

Use accessible buttons with primary, secondary, ghost, and danger variants, three sizes, icons, loading, and aria-busy states.

opt-ui

Input

Core

Use a standalone text input with labels, errors, hints, and icons.

opt-ui

Switch

Core

Toggle a setting with three sizes and explicit accessible associations for labels and descriptions.

opt-ui

Textarea

Core

Enter multiline text with the same label, error, and hint API as Input.

PreviousCheckboxNextDateRangePicker