라디오 버튼

라디오 버튼은 사용자가 여러 개의 옵션 중 한 개의 값을 선택할 수 있도록 하는 경우에 사용한다.

사용 지침

선택지가 2~7개로 한정되고 모든 항목을 한눈에 보여 줘야 할 때 사용하며, 같은 name으로 그룹을 묶어 화살표 키 이동과 fieldset/legend 패턴으로 접근성을 보장합니다.

예제

기본

examples/radio-group/RadioDefault.tsx
import { Radio, RadioGroup } from "@/components/ui/radio-group"

export default function RadioDefault() {

설명 포함

부가적인 설명이 들어갑니다.
examples/radio-group/RadioWithDescription.tsx
import { Radio, RadioGroup } from "@/components/ui/radio-group"

export default function RadioWithDescription() {

크기

examples/radio-group/RadioSize.tsx
import { Radio, RadioGroup } from "@/components/ui/radio-group"

export default function RadioSize() {

비활성화

examples/radio-group/RadioDisabled.tsx
import { Radio, RadioGroup } from "@/components/ui/radio-group"

export default function RadioDisabled() {

선택된 비활성화

examples/radio-group/RadioCheckedDisabled.tsx
import { Radio, RadioGroup } from "@/components/ui/radio-group"

export default function RadioCheckedDisabled() {

라디오 그룹 예제

examples/radio-group/RadioGroupExample.tsx
import { Radio, RadioGroup } from "@/components/ui/radio-group"

export default function RadioGroupExample() {

라디오 그룹 세로 배치

부가적인 설명이 들어갑니다.
부가적인 설명이 들어갑니다.
examples/radio-group/RadioGroupColumn.tsx
import { Radio, RadioGroup } from "@/components/ui/radio-group"

export default function RadioGroupColumn() {

라디오 그룹 세로 배치 (제어 상태)

부가적인 설명이 들어갑니다.
부가적인 설명이 들어갑니다.
examples/radio-group/RadioGroupColumnControlled.tsx
"use client"

import { useState } from "react"

examples/radio-group/RadioChipDefault.tsx
"use client"

import { RadioChip, RadioGroup } from "@/components/ui/radio-group"

정렬 변형

examples/radio-group/RadioSortDefault.tsx
import { RadioGroup, RadioSort } from "@/components/ui/radio-group"

export default function RadioSortDefault() {

속성

이름타입기본값설명
aria-labelstringDefines a string value that labels the current element. @see aria-labelledby.
classNamestring
defaultCheckedboolean
descriptionstring
disabledboolean
idstring
onClickMouseEventHandler<HTMLInputElement>
sizeenummedium
styleCSSProperties
tabIndexnumber
typeHTMLInputTypeAttribute