RwComboBox
RwComboBox는 객체 목록에서 값을 검색하고 선택해 모델 속성에 연결하는 Carbon 스타일 콤보박스입니다.
선택 목록 구성
ItemsSource의 항목을 DisplayField로 보여 주고 ValueField 값을 ItemSource의 Path에 저장합니다. 목록 필터, 지우기, 드롭다운 단추, 사용자 템플릿과 별도 필터 창을 선택적으로 사용할 수 있습니다.
단일 선택에 적합한 경우
코드와 표시명이 분리된 기준정보 선택, 모델 선택과 사용자 선택에 적합합니다. 선택지가 두세 개뿐이면 라디오나 옵션 목록이 더 명확할 수 있습니다.
데이터와 표시 필드
| 파라미터 | 용도 |
|---|---|
| ItemsSource | 선택 가능한 객체 목록입니다. |
| ItemSource / Path | 선택값을 저장할 모델과 속성입니다. |
| ValueField | 실제로 저장할 항목 속성입니다. |
| DisplayField | 목록과 선택 영역에 표시할 속성입니다. |
| FilterFields | 검색 대상이 될 추가 속성 목록입니다. |
| UseFilter | 입력 검색을 사용할지 결정합니다. |
| UseClearButton | 선택 초기화 단추를 표시합니다. |
| ValueChanged | 선택 변경 결과를 전달합니다. |
목록 바인딩
- ItemsSource를 준비하고 null 항목을 제거합니다.
- ValueField와 DisplayField를 실제 속성명으로 지정합니다.
- 저장 모델과 Path를 연결합니다.
- 검색이 필요하면 UseFilter와 FilterFields를 설정합니다.
- ValueChanged에서 연관 필드를 갱신하고 선택 결과를 확인합니다.
선택값 변경
ValueChanged는 선택 항목과 값 정보를 포함한 RxComboBoxEvent를 전달합니다. 목록을 다시 불러올 때 현재 값이 새 ItemsSource에 존재하는지 확인하고, 필요하면 명시적으로 초기화합니다.
키보드 탐색
AriaLabel을 지정하고 키보드 방향키, Enter와 Escape로 목록을 조작할 수 있는지 확인합니다. 선택값을 색상이나 아이콘만으로 구분하지 않습니다.
목록 재조회
ValueField와 Path의 형식이 다르면 선택은 보여도 저장값이 갱신되지 않을 수 있습니다. DisplayContent는 목록 HTML을 만들기 때문에 데이터 값을 그대로 HTML로 삽입하지 않습니다. OpenOnFocus는 긴 목록에서 불필요한 팝업을 만들 수 있습니다.
선택 화면 점검
- 초기 선택이 올바르게 표시되는지 확인합니다.
- 검색, 선택, 지우기 이벤트를 확인합니다.
- ItemsSource 재조회 후 선택값이 유지되는지 확인합니다.