GPUI Deck

Select

옵션을 갱신할 수 있는 단일 선택, 버퍼링되는 타입어헤드, Home/End와 화살표 내비게이션, 비활성화된 옵션, 확정과 포커스를 제공합니다.

GPUI 웹 백엔드가 그리는 실제 컴포넌트입니다. WebGPU를 지원하는 브라우저가 필요합니다.

시간대 목록을 열고 Home, End, 방향키를 누르거나 도시 이름의 첫 글자를 입력해 보세요. 강조된 항목이 보이도록 목록이 스크롤되고, Enter를 누르면 선택이 확정됩니다. 휠로 다른 항목을 둘러볼 수도 있습니다. 짧은 목록은 내용에 맞게 표시되며 Select::list_max_height(px(144.))로 창 안에서 사용할 최대 높이를 줄일 수 있습니다.

Show Asia only를 누르면 시간대 목록이 아시아로 좁혀집니다. 선택했던 서울은 유지되고 아시아 밖의 도시는 선택이 해제됩니다. 네이티브 녹화 예제도 같은 API를 사용해 Presentation 프리셋에서 레이저 도구를 활성화합니다.

SelectState::new(items, cx)는 순서가 있는 고유한 값 집합, 확정된 값 하나, 그리고 별도의 열린 팝업 커서를 소유합니다. 비활성화된 옵션은 건너뜁니다. 화면 표현에는 상태를 관찰하고, 사용자가 확정한 변경에는 SelectEvent::Change를 구독합니다. set_selected_value(Some(value), window, cx)는 활성화된 값을 설정하고, None은 값을 지웁니다. 받아들여진 갱신은 사용자 이벤트 없이 팝업을 닫으며 일반적인 포커스 복원을 사용합니다. 알 수 없거나 비활성화된 값은 값, 대기 중인 커서, 팝업을 바꾸지 않고 false를 반환합니다. 컨트롤 전체가 비활성화된 동안에도 애플리케이션 갱신은 가능합니다.

set_items(items, window, cx)는 옵션의 고유 값으로 확정된 선택과 강조된 항목을 찾습니다. 목록이 열려 있다면 키보드 포커스를 유지합니다. 강조된 항목이 사라지거나 비활성화되면 현재 선택이나 첫 번째 활성 옵션으로 이동합니다. 활성 옵션이 없으면 목록을 닫습니다. 이 갱신은 SelectEvent::Change를 발생시키지 않습니다.

입력결과
Enter / Space팝업을 열거나, 강조된 옵션을 확정
Up / Down팝업을 열고 활성화된 옵션 사이를 이동
열린 상태에서 Home / End확정하지 않고 첫 번째 / 마지막 활성화된 옵션을 강조
출력 가능한 문자닫힌 상태에서는 일치하는 옵션을 확정하고, 열린 상태에서는 강조
Escape대기 중인 선택을 버리고, 닫은 뒤 트리거 포커스를 복원

타입어헤드는 대소문자를 구분하지 않고 레이블 접두사를 비교하며, 1초 후 초기화됩니다. 같은 글자를 반복하면 일치하는 옵션을 순환합니다. 수정자 키가 포함된 단축키, 네이티브 문자 우선 이벤트, 하위 편집기에서 온 키는 검색하지 않습니다. 열거나 닫으면 접두사가 지워집니다. 이것은 편집할 수 없는 select입니다. 보이는 네이티브 텍스트 쿼리, 그룹화된 결과, 다중 선택이 필요하면 Combobox를 사용합니다.