---
{"id":"search","title":"검색 입력","category":"컴포넌트","order":39,"summary":"현재 목록 또는 전체 제품의 관련 항목 찾기의 사용·상태·접근성 계약.","status":"문서 기준 · UI 미검증","references":["components/search/usage"]}
---

# 검색 입력

## 목적과 사용

현재 목록 또는 전체 제품의 관련 항목 찾기에 사용합니다. 페이지 이동 메뉴나 값 저장 필드처럼 오해시키지 않습니다.

## 구성과 변형

검색 범위 라벨, 입력, 실행/지우기, 결과 피드백. 변형의 외형은 각 제품의 기존 [토큰](tokens.md)을 사용합니다. Carbon의 크기·색·모서리·아이콘을 가져오지 않습니다.

## 동작 규칙

- SRC-01 MUST: 검색 범위를 사용자에게 알립니다.
- SRC-02 MUST: ‘결과 없음’과 ‘검색 실패’를 구분합니다.
- SRC-03 SHOULD: 한글 IME 조합 중 요청을 과도하게 보내거나 Enter 제출하지 않습니다.
- SRC-04 MUST: 늦게 끝난 이전 요청이 최신 결과를 덮지 않게 합니다.

## 접근성

검색 영역 이름, 지우기 버튼 이름, 결과 수의 과도하지 않은 알림을 제공합니다. 공통 [접근성 기준](accessibility.md)도 함께 적용합니다.

## 콘텐츠 예시

좋음: ‘이 서버의 파일 검색’ / 피함: 검색 범위를 알 수 없는 돋보기.

## 우리 구현과 연결

문서 사이트 검색은 로컬 문서 본문만 검색합니다. 제품·고객 DB와 연결되지 않습니다.

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

## 상태와 검증

빈 쿼리·특수문자·한글·빠른 변경·지연·0건·권한 제한을 확인합니다.

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