TeamWicked Design System / 컴포넌트

드롭다운·콤보박스

정렬·필터·검색 가능한 단일/다중 값 선택을 위한 컴포넌트.

적용 범위: TeamWicked 자체 브랜드·웹사이트. 호스팅 제품의 외형은 포함하지 않습니다. 공통 동작 규칙을 재사용하며, 다른 체계의 사례는 비교 근거일 뿐 스타일 상속이 아닙니다.

실행형 예제
입력해서 목록에서 선택해 보세요.
아직 선택하지 않았습니다.
TeamWicked 웹사이트 토큰으로 구성한 동작 예제예시 데이터 · API 미연결

목적과 사용

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

구성과 변형

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

동작 규칙

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

콘텐츠 예시

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

우리 구현과 연결

TeamWicked 자체 웹사이트의 토큰과 CTA를 사용합니다. vPanel·Pterodactyl·Store의 구현은 WickedHost 체계에 속하며 이 체계의 컴포넌트를 정의하지 않습니다. 실행 예제의 원본 경로는 구현 코드 탭을 확인하세요.

상태와 검증

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

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

출처와 적용 범위

원본 확인 범위와 운영 적용 여부를 구분합니다. 실행형 예제의 동작 확인은 모든 운영 화면의 접근성 검증을 의미하지 않습니다.

Markdown 원본 다운로드