GPUI Deck

Slider

1 つ以上の順序付きの数値、範囲を限定したステップ、つまみごとのフォーカスとアクセシビリティ、キーボード/ポインターによる調整、無効状態、垂直と RTL のジオメトリに対応します。

GPUI の Web バックエンドが描画する実際のコンポーネントです。WebGPU 対応のブラウザが必要です。

SliderState::new(min..=max, step, [values...], cx) を一度だけ作成します。値が 1 つなら つまみ 1 つのスライダーになり、2 つの値は範囲を表し、それ以上の値は順序付きの 停止点を追加します。空でないコレクションがつまみの数を決めます。範囲と値は 有限で、min < max、step は正でなければなりません。値は丸められ、 最小値から始まるステップのグリッドに合わせられます。範囲は両端を含みます。

名前付きのグループとレールとして Slider::new(id, &state).accessibility_label(...) を描画します。 トラックとフィル、そして値ごとに 1 つの SliderThumb::new(&state, index).accessibility_label(...) を順序どおりに指定します。 各つまみは、ネイティブの Slider ロール、フォーカス、キー、値のアクションを持ちます。範囲の 両端には、"Trim start" と "Trim end" のように異なる名前を付けてください。percentage(index) は、 そのつまみの位置を 0 から 1 で返します。ルートの範囲が移動のレールを定義します。つまみの 中心をルートのその割合の位置に置き、アプリケーションのつまみのサイズの半分だけオフセットします。 サンプルは、操作しやすい高さのヒット領域と、その内側の中央に配置した細いトラックを使用しています。 色もコントロールの寸法も、ライブラリは強制しません。

State は 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) は、正規化された値が変化したときに 順序付きの完全な値を 1 回通知します。アプリケーションの視覚表現を更新するには State を observe します。

レールの押下は最も近いつまみを選び、ドラッグはリリースするまで、レールの外でも そのつまみを保ちます。axis(Axis::Vertical) は最小値を下に配置し、 水平方向の値は論理的な方向に従います。各つまみは、アクセシブルな名前、向き、現在の値、ステップ、 隣のつまみによって制限された数値の範囲を公開します。つまみのフォーカス表示は アプリケーションが指定します。

入力動作
Left / Down1 ステップ減らします
Right / Up1 ステップ増やします
Home / Endフォーカスされたつまみの許容される最小値 / 最大値に設定します
PageDown / PageUp10 ステップ減らす / 増やします
Tab / Shift-Tab有効な各つまみを値の順に巡り、その後グループから離れます

無効なスライダーはユーザーによる変更を無視し、Tab ではスキップされます。フォーカス中に 無効になったスライダーは、Tab で離れられるよう、しばらくフォーカスのバインディングを保ちます。 セッションのプレビューはつまみ 1 つを使用します。カタログのメディアトリミングのコントロールは、2 つの 独立した端を使用し、水平/垂直のジオメトリと RTL を切り替えます。