---
{"id":"dropdown","title":"드롭다운·콤보박스","category":"컴포넌트","order":38,"summary":"정렬·필터·검색 가능한 단일/다중 값 선택의 사용·상태·접근성 계약.","status":"문서 기준 · UI 미검증","references":["components/dropdown/usage"]}
---

# 드롭다운·콤보박스

## 목적과 사용

정렬·필터·검색 가능한 단일/다중 값 선택에 사용합니다. 단순 폼에 커스텀 팝업이 불필요하면 네이티브 셀렉트를 사용합니다.

## 구성과 변형

트리거, 목록, 선택 상태, 선택적 검색·해제. 변형의 외형은 각 제품의 기존 [토큰](tokens.md)을 사용합니다. Carbon의 크기·색·모서리·아이콘을 가져오지 않습니다.

## 동작 규칙

- DRP-01 MUST: 단일·다중 선택 여부와 현재 선택 수를 알 수 있게 합니다.
- DRP-02 MUST: 검색 결과 없음과 옵션 조회 실패를 구분합니다.
- DRP-03 MUST: 입력 문자열이 선택된 실제 옵션인 것처럼 저장되지 않게 합니다.
- DRP-04 SHOULD: 선택 후 닫힘·다중 선택 유지 정책을 일관되게 적용합니다.

## 접근성

선택기와 명령 메뉴의 역할을 혼합하지 않습니다. 방향키·Enter·Escape와 포커스 복귀를 검증합니다. 공통 [접근성 기준](accessibility.md)도 함께 적용합니다.

## 콘텐츠 예시

좋음: ‘선택된 템플릿 2개’ / 피함: 선택한 항목이 접힌 뒤 사라짐.

## 우리 구현과 연결

VPS Mantine 등 제품에 설치된 접근 가능한 기반 위젯을 우선 검토합니다. 신규 공통 구현은 없습니다.

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

## 상태와 검증

지연 검색·한글 조합·빈 결과·선택 제거·화면 가장자리를 확인합니다.

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