Skip to content

ScRadioButtonGroup

ScRadioButtonGroup은 배열 형태의 옵션 목록을 기반으로 구성된 라디오 버튼 그룹 컴포넌트입니다.
v-model로 바인딩된 선택 값을 관리하며, 옵션 목록, 크기, 스타일 타입, 색상, 비활성화 상태를 prop으로 설정할 수 있습니다.

✅ 기본 사용법

결과 : korean
vue
<div>
  <sc-radio-button-group :items="items" v-model="value" width="400" @click="onClick" />
</div>

<div class="mt-5">결과 : {{ value }}</div>

<script setup>
const items = ref([
  { value: 'korean', text: '한글' },
  { value: 'english', text: '영문' },
  { value: 'chinese', text: '중문' },
]);
</script>

✨ 사용 예시 모음

▸ 비활성화 disabled

vue
<sc-radio-button-group :items="items" v-model="value" width="400" disabled />

▸ 넓이 width

vue
<div class="mt-5 flex flex-col gap-4">
  <sc-radio-button-group :items="items" v-model="value" width="200" />
  <sc-radio-button-group :items="items" v-model="value" width="300" />
  <sc-radio-button-group :items="items" v-model="value" width="400" />
</div>

🛠️ 속성 (Props)

이름타입기본값설명
itemsArray[]라디오 버튼 항목 배열 (문자/숫자/객체 모두 지원)
modelValueString | Number | Boolean''선택된 값 (v-model)
colorString'black'버튼 색상 (현재 'black'만 지원)
disabledBooleanfalse전체 그룹 비활성화 여부
sizeString'medium'버튼 크기: 'small', 'medium', 'large'
widthString | Number''그룹의 너비 (200, '300px', 등)
itemTextString'text'객체 데이터 사용 시, 표시 텍스트 key
itemValueString'value'객체 데이터 사용 시, 실제 값 key

📤 이벤트 (Emits)

이벤트 이름설명
update:modelValue선택 변경 시 발생
click버튼 클릭 시 발생
change선택 변경 시 발생

🔳 슬롯 (Slots)

이 컴포넌트는 슬롯을 지원하지 않습니다.


🎨 스타일 클래스

클래스 이름설명
sc-radio-button-group버튼 그룹 wrapper
.sc-radio-button-group.disabled버튼 그룹 비활성화
button각 라디오 버튼
button.active선택된 버튼
button:hover마우스 오버