> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/dev-guide/pjt-prepare/ui-ux/undefined-3/undefined.md).
# 조회 영역 상세 가이드
### 조회 및 데이터 항목
조회 영역은 데이터를 조회하기 위한 조건을 설정하는 영역으로 결과 데이터 영역의 상단에 위치합니다.
메뉴를 클릭하여, 화면이 나타난 경우, 조회 영역의 활성화된 가장 처음에 포커스를 제공합니다.
List & Detail 조회 시 한 화면에서 목록과 상세 CRUD 처리하는 화면의 조회 영역은 상/하, 좌/우로 구성할 수 있습니다.
* 조회 영역 예시
#### 1. 조회 조건 항목
* 콤보 박스는 선택 형 조회 조건의 경우에 우선 적용합니다.
* 30건 이하 콤보 구성 - 그 이사 팝업으로 처리
* 디폴트 옵션 또는 “선택”을 반드시 표시
* 전체 선택 빈도가 높을 시 예외적으로 ‘전체’를 디폴트 옵션으로 적용 가능
* 팝업화면은 선택형 조회조건 대상 데이터가 30건 이상 일 때 적용합니다.
* 라디오 버튼은 예/아니오 등 향후 추가 될 데이터가 없는 선택 조회 조건시 사용합니다.\
예외) 선택 데이터를 한눈에 나타내야하는 경우 제한적으로 사용
* 체크박스는 복수 선택이 필요할때 사용합니다.
#### 2. 필수 조회 조건
필수 입력 표시는 항목에 별도로 필수 입력 표기를 진행합니다.
### 조회 조건 항목 상세
#### 1. 항목 배치
조회 조건 항목의 배치는 중요도, 사용 빈도, 범위가 큰 순서를 먼저 배치합니다.
* 관련있는 조건은 좌우로 나란히 배치합니다.
* 중요도에 따라 예외 사항을 둘 수 있습니다.
* 항목명은 좌측 정렬을 원칙으로 합니다.
#### 2. 항목 배치 순서
항목의 배치는 작업 흐름에 따라 배치 합니다.
* 1 → 2 → 3 → 4 순으로 배치합니다.
* 이동 방향은 Z방향이며, Tab키를 클릭해 이동할 수 있습니다.
#### 3. 조회 버튼 위치
조회 버튼은 전체 영역 버튼으로 배치합니다.
#### 4. 자동 완성 기능
자동 완성 기능 적용 예시는 다음과 같습니다.
* 자주 사용하는 조회 정보가 있는 경우 기본값을 제공합니다.
* 사전에 연동되는 정보가 있는 경우 조회 영역에 데이터를 표시하고 조회 결과를 노출합니다.
* 검색어를 입력하여 조회 하는 경우 자동완성 기능을 사용됩니다.
