---
{"id":"checkbox","title":"체크박스","category":"컴포넌트","order":34,"summary":"여러 개의 독립 선택·선택 동의의 사용·상태·접근성 계약.","status":"문서 기준 · UI 미검증","references":["components/checkbox/usage"]}
---

# 체크박스

## 목적과 사용

여러 개의 독립 선택·선택 동의에 사용합니다. 하나만 고르는 경우 라디오, 즉시 적용되는 켜기/끄기는 스위치를 검토합니다.

## 구성과 변형

그룹 라벨, 체크 상태, 개별 설명. 변형의 외형은 각 제품의 기존 [토큰](tokens.md)을 사용합니다. Carbon의 크기·색·모서리·아이콘을 가져오지 않습니다.

## 동작 규칙

- CHK-01 MUST: 각각의 선택이 다른 항목을 조용히 해제하지 않습니다.
- CHK-02 MUST: 전체 선택의 범위가 현재 페이지인지 전체 결과인지 명시합니다.
- CHK-03 MUST: 일부 선택은 혼합 상태로 표시합니다.
- CHK-04 MUST: 동의가 필요한 내용은 관련 링크와 함께 읽을 수 있게 제공합니다.

## 접근성

fieldset/legend로 묶고 label로 클릭 범위를 확보합니다. Space로 전환합니다. 공통 [접근성 기준](accessibility.md)도 함께 적용합니다.

## 콘텐츠 예시

좋음: ‘현재 페이지 10개 선택’ / 피함: 범위 없는 ‘전체’.

## 우리 구현과 연결

Panel 파일 선택과 각 제품의 일괄 선택은 대상 재확인이 필요합니다. 구현 현황은 화면별 미검증입니다.

제품별 소유 경로는 [WICKEDVPS](product-vps.md), [Panel](product-panel.md), [Blesta](product-blesta.md)와 [소스 근거](source-evidence.md)를 확인합니다. 코드 존재와 모든 사용처의 준수는 다르며, 별도 표시가 없는 제품별 준수 상태는 미검증입니다.

## 코드 계약 예시

다음은 의미 구조 설명용이며 운영 API에 연결된 완성 구현이 아닙니다.

```html
<fieldset><legend>알림 종류</legend>
<label><input type="checkbox" name="mail"> 이메일 알림</label></fieldset>
```

## 상태와 검증

0개·1개·일부·전체·필터 변경 후 숨겨진 선택을 확인합니다.

일반·hover·focus·실행 중·실패·성공·disabled·read-only 중 해당하는 상태를 기록합니다. 해당하지 않는 상태를 임의로 만들지 말고 이유를 남깁니다. [검증 체크리스트](testing.md)에 증거를 연결합니다.