GitHub

Radio Group

한 번에 하나만 선택할 수 있는 라디오 버튼 그룹입니다.

부가적인 설명이 들어갑니다.

부가적인 설명이 들어갑니다.

examples/krds/radio-group-demo.tsx
import { Label } from "@/components/ui/label"
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group"

설치

pnpm dlx shadcn@latest add https://krdscn.gwlee.kr/r/radio-group.json

사용법

import { Label } from "@/components/ui/label"
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group"
<RadioGroup defaultValue="option-one">
  <div className="flex items-center gap-3">
    <RadioGroupItem value="option-one" id="option-one" />
    <Label htmlFor="option-one">Option One</Label>
  </div>
  <div className="flex items-center gap-3">
    <RadioGroupItem value="option-two" id="option-two" />
    <Label htmlFor="option-two">Option Two</Label>
  </div>
</RadioGroup>

구성

다음 조합으로 RadioGroup:

RadioGroup
├── RadioGroupItem
└── RadioGroupItem

예제

Description

Radio group items with a description using the Field component.

Standard spacing for most use cases.

More space between elements.

Minimal spacing for dense layouts.

examples/krds/radio-group-description.tsx
import {
  Field,
  FieldContent,

Choice Card

Use FieldLabel to wrap the entire Field for a clickable card-style selection.

examples/krds/radio-group-choice-card.tsx
import {
  Field,
  FieldContent,

Fieldset

Use FieldSet and FieldLegend to group radio items with a label and description.

Subscription Plan

Yearly and lifetime plans offer significant savings.

examples/krds/radio-group-fieldset.tsx
import {
  Field,
  FieldDescription,

Disabled

RadioGroupItem에 disabled prop을 사용해 개별 항목을 비활성화합니다.

examples/krds/radio-group-disabled.tsx
import { Field, FieldLabel } from "@/components/ui/field"
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group"

Invalid

Use aria-invalid on RadioGroupItem and data-invalid on Field to show validation errors.

Notification Preferences

Choose how you want to receive notifications.

examples/krds/radio-group-invalid.tsx
import {
  Field,
  FieldDescription,

RTL

RTL 지원을 활성화하려면 RTL 설정 가이드를 참고하세요.

تباعد قياسي لمعظم حالات الاستخدام.

مساحة أكبر بين العناصر.

تباعد أدنى للتخطيطات الكثيفة.

examples/krds/radio-group-rtl.tsx
"use client"

import * as React from "react"

API 참조

Radix UI Radio Group 문서를 참고하세요.