GPUI Deck

Resizable

複数パネルのサイズ、連鎖するポインター/キーボードでのリサイズ、パネルごとの比率とピクセルの制限、折りたたみ可能なパネル、保持されるサイズ、ネイティブのスプリッターのセマンティクスに対応します。

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

Resizable は、範囲を限定したフレームを、フォーカス可能な区切りで分けられた、連続してレイアウトされる 2 つ以上のパネルに分割します。その State は、パネルのサイズ、各 パネルの制約、区切りごとのフォーカスハンドルを管理します。

let split = cx.new(|cx| {
    ResizableState::new(
        Axis::Horizontal,
        [
            ResizablePanel::new(0.25).limits(0.15..=0.4).collapsible(0.),
            ResizablePanel::new(0.5).limits(0.3..=1.),
            ResizablePanel::new(0.25).limits(0.15..=0.4),
        ],
        cx,
    )
});

Resizable::new("workspace", &split)
    .size_full()
    .panel(sidebar)
    .panel(editor)
    .panel(inspector)
    .handle(|index, handle| {
        handle
            .accessibility_label(["Sidebar width", "Editor width"][index])
            .w(px(6.))
            .bg(divider_color)
    })

設定されたパネルごとに 1 つの panel を、順序どおりに指定します。handle は、各区切りをそのインデックスから 構築します。インデックスは、その直前のパネルのインデックスです。 Axis::Horizontal はパネルを左から右に配置してハンドルの幅を使用し、 Axis::Vertical は上から下に配置してハンドルの高さを使用します。フレームの 寸法に上限を与え、ハンドルには実際の太さを与えてください。サイズは、区切りの太さを除いた 使用可能な空間に対する比率で、合計が 1 になり、親がリサイズされても 比例関係を保ちます。フレームのパディングはサポートされており、内部のレイアウトには隙間がありません。

ResizablePanel::new(default) は 0 から 1 の間で自由な状態から始まります。limits は 展開時のサイズを制限し、collapsible(size) はそれより小さい折りたたみ時の サイズを許可します。デフォルトがパネルの制約に違反する場合や 合計が 1 にならない場合、State の構築はパニックします。pixel_limits(min..=max) は、グループが測定された後に 適用される論理ピクセルの制限を追加し、比率の制限とピクセルの制限のうち厳しい方が 優先されます。測定された空間が変化したとき、新しい制限を破るレイアウトは 近いものから順に 1 度だけ調整し直され、Change を発行します。まだ有効なレイアウトは 比率を保ちます。空間がすべてのピクセル制限を満たせない場合、満たせるようになるまで、グループは 比率の制限のみを使用します。区切りの値と Home/End は 測定された制限を反映します。

区切りを動かすと、一方の側のパネルが大きくなり、反対側のパネルが 近いものから順に小さくなるため、最小サイズのパネルは移動を次の パネルに渡します。どのパネルも吸収できない移動では、区切りはその場に留まります。折りたたみ可能なパネルの 最小サイズと折りたたみサイズの中間を越えてドラッグすると、スナップして 閉じ、その点を越えて戻すと最小サイズで再び開きます。

入力結果
区切りをドラッグ実際の押下位置からリサイズし、制約の範囲内で連鎖します
水平グループでの Left / Right区切りの前のパネルを 2 パーセントポイント縮小 / 拡大します
垂直グループでの Up / Down区切りの前のパネルを 2 パーセントポイント縮小 / 拡大します
折りたたまれたパネルに向かう矢印最小サイズで再び開きます
最小サイズの折りたたみ可能なパネルから離れる向きの矢印折りたたみます
Home / End区切りの前のパネルに、許容される最小 / 最大のサイズを与えます
Enter区切りの前の折りたたみ可能なパネルを折りたたむ、または最後のサイズに戻します
Tab / Shift+Tab区切りとパネル内のコントロールを通常のドキュメント順に移動します

Home、End、Enter は APG のウィンドウスプリッターパターンに従います。 リサイズのキーコンテキストを持つのは区切りだけです。パネル内のテキスト編集、選択、スクロールは それぞれ独自の動作を保ちます。ポインターのドラッグは GPUI のドラッグの ライフサイクルを使用し、所有する State と区切りを識別するため、独立した、またはネストした グループが、他の区切りのドラッグに反応することはありません。

各区切りはネイティブの Splitter ロールを持ち、その数値、制限、ステップは 直前のパネルをパーセントで表します。ネイティブの向きは 区切り線を表します。各区切りには、調整するパネルを示すラベルを付け、 グリップの子要素は操作できないようにしてください。スタイルはすべてアプリケーションが指定します。

サイズ 0 に折りたたまれたパネルはコンテンツをアンマウントするため、フォーカス ストップやアクセシビリティノードを持ちません。フォーカスが内部にあった場合は、隣の 区切りに移動します(リサイズが無効な間はグループ自体に移動します)。アイコンレールのような、0 でない折りたたみ サイズでは、コンテンツはマウントされたままです。

プレゼンテーションを更新するには State を observe します。sizes()、panel_count()、 is_collapsed(index)、axis()、handle_focus(index)、is_disabled() が その契約を公開します。set_sizes はレイアウト全体を置き換え、無効なものではパニックし、 その後、測定されたピクセル制限に合わせて調整します。レイアウトを永続化するには、 ResizableEvent::Change の sizes() をアプリケーションのストレージに保存し、 次の起動時に set_sizes に渡します。 collapse(index) と expand(index) は折りたたみ可能なパネルに作用し、隣のパネルが変化を 吸収できない場合は何もしません。レイアウトが変わるたびに、プログラムによる更新も含めて 1 回 ResizableEvent::Change(sizes) が発行されます。set_disabled は ポインター、キーボード、アクセシビリティによるリサイズと通常の Tab の進入をブロックします。 フォーカスされた区切りはバインディングを保つため、Tab で離れられます。

Schedule のサンプルは、共有のノートを折りたたみ可能な最初のパネルに、 計画の表を 2 軸の ScrollArea 内の 2 番目のパネルに置き、後者は少なくとも 96 px を保ちます。 タブを閉じたり切り替えたりしても、 アプリケーションがそれらの State を保持しているため、テキストとサイズは保たれます。 ライブラリはファイルを書き込まず、保存先はアプリケーションが決めます。