GPUI Deck

Slider

하나 이상의 순서가 있는 숫자 값, 범위가 있는 단계, 썸별 포커스와 접근성, 키보드/포인터 조절, 비활성화 상태, 세로 및 RTL 배치를 제공합니다.

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

SliderState::new(min..=max, step, [values...], cx)를 한 번 생성합니다. 값이 하나면 썸이 하나인 슬라이더가 되고, 값이 두 개면 범위를 나타내며, 그보다 많으면 순서가 있는 지점이 추가됩니다. 비어 있지 않은 컬렉션이 썸 개수를 고정합니다. 범위와 값은 유한해야 하고, min < max이며, step은 양수여야 합니다. 값은 범위 안으로 고정되고, 최솟값에서 시작하는 단계 격자에 맞춰집니다. 범위는 양 끝을 포함합니다.

Slider::new(id, &state).accessibility_label(...)를 이름이 있는 그룹이자 레일로 렌더링합니다. 트랙과 채움을 제공하고, 값마다 순서대로 SliderThumb::new(&state, index).accessibility_label(...)를 하나씩 제공합니다. 각 썸은 자신의 네이티브 Slider 역할, 포커스, 키, 값 액션을 소유합니다. 범위의 양 끝에는 "Trim start"와 "Trim end"처럼 서로 다른 이름을 지정합니다. percentage(index)는 해당 썸의 위치를 0부터 1까지로 제공합니다. 루트의 경계가 이동 레일을 정의합니다. 썸의 중심을 루트의 해당 비율 위치에 두고, 애플리케이션의 썸 크기의 절반만큼 오프셋합니다. 예제는 넉넉한 높이의 히트 영역과 그 안 가운데에 놓인 얇은 트랙을 사용합니다. 라이브러리는 색상이나 컨트롤 크기를 강제하지 않습니다.

상태는 values, min_value, max_value, step_value, percentage, thumb_focus_handle(index), is_disabled를 노출합니다. 프로그래밍 방식의 갱신에는 set_thumb_value(index, value, window, cx) 또는 set_values(values, window, cx)를 사용하고, 사용자 상호작용을 제어하려면 set_disabled(disabled, window, cx)를 사용합니다. 비활성화된 동안에도 프로그래밍 방식의 갱신은 가능합니다. 개별 썸은 이웃 썸에서 멈추며 서로 정체성을 바꾸지 않습니다. 같은 값은 허용됩니다. 정규화된 값이 바뀌면 SliderEvent::Change(values)가 순서가 있는 전체 값을 한 번 보고합니다. 애플리케이션의 시각 요소를 갱신하려면 상태를 관찰합니다.

레일을 누르면 가장 가까운 썸을 선택하며, 드래그하는 동안에는 레일 밖으로 나가도 놓을 때까지 그 썸을 유지합니다. axis(Axis::Vertical)은 최솟값을 아래쪽에 두고, 가로 값은 논리적 방향을 따릅니다. 각 썸은 접근 가능한 이름, 방향, 현재 값, 단계, 그리고 이웃 썸에 의해 제한되는 숫자 범위를 노출합니다. 썸의 포커스 표현은 애플리케이션이 제공합니다.

입력동작
Left / Down한 단계 감소
Right / Up한 단계 증가
Home / End포커스된 썸을 허용되는 최솟값 / 최댓값으로 설정
PageDown / PageUp열 단계 감소 / 증가
Tab / Shift-Tab활성화된 각 썸을 값 순서대로 방문한 뒤 그룹을 떠남

비활성화된 슬라이더는 사용자 변경을 무시하며 Tab에서 건너뜁니다. 포커스된 상태에서 비활성화된 슬라이더는 Tab으로 떠날 수 있을 만큼 포커스 바인딩을 유지합니다. 세션 미리보기는 썸 하나를 사용하고, 카탈로그의 미디어 트림 컨트롤은 독립적인 양 끝 두 개를 사용하며 가로/세로 배치와 RTL 사이를 전환합니다.