사용법
레이블
label과 description으로 체크박스의 의미를 전달해요. 필수·선택 항목을 구분해 표시해요.
서비스 이용에 필요해요.
선택 항목이에요.
스타일 커스터마이징
Checkbox 사용 시 className, style, `classNames`로 모든 스타일을 변경할 수 있어요. CSS 변수는 컴포넌트 루트에 지정하면 variant 기본값을 덮어써요.
className / style
<Checkbox
className="shadow-md"
style={{
--gtd-checkbox-bg: "#059669",
}}
/>classNames 슬롯
복합 컴포넌트는 영역별로 클래스를 지정할 수 있어요.
<Checkbox
classNames={{
root: "my-checkbox-root",
copy: "my-checkbox-copy",
label: "my-checkbox-label",
description: "my-checkbox-description",
control: "my-checkbox-control"
}}
/>CSS 변수
| 변수 | 설명 |
|---|---|
| --gtd-checkbox-bg | 체크박스 배경 |
| --gtd-checkbox-checked-bg | 선택 시 배경 |
| --gtd-checkbox-border-color | 테두리색 |
인터페이스
CheckboxProps
| 속성 | 타입 | 기본값 | 설명 |
|---|---|---|---|
| label | string | — | 레이블 |
| description | string | — | 보조 설명 |
| checked | boolean | — | 제어형 checked |
Checkbox 컴포넌트 Props 표
가져오기
import { Checkbox } from "@/components/ui/Checkbox";