GPUI Deck

Combobox

編集可能な単一/複数選択、グループ化された検索結果、差し替え可能なオプション、キーボード/ポインターによる確定、下書きのキャンセルに対応します。

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

プレビューで s を入力して Enter を押すと SvelteKit が選択されます。矢印キーは表示された検索順位に沿って移動し、無効な項目を飛ばします。

順序付きで一意な SearchItem::new(value, label) エントリから ComboboxState::new(items, window, cx) を構築します。.keywords(...) はエイリアスを追加し、 .disabled(true) は利用できない選択肢を示し、.group(label) は名前付きの 結果グループを割り当てます。各グループの項目は、ソース順で連続させてください。 共有の Command エンジンがネイティブのクエリ編集、フィルタリング、ハイライト、 スクロールを担当し、Combobox は確定した選択とポップアップのライフサイクルを担当します。

デフォルトは単一選択です。.multiple(true) で複数の確定値を許可します。 set_selected_values([values...], window, cx) はユーザーイベントなしで選択を初期化または 置換し、空のイテレーターで選択をクリアします。不明な値や無効な値、および単一モードでの 2 つ以上の異なる値は拒否されます。アプリケーションでの表示には selected_indices()、is_selected(index)、selected_items(cx)、selected_values(cx) を読み取ります。 ユーザーの操作は、選択が変わった場合にのみ、項目の順序で ComboboxEvent::Change(values) を発行します。

Combobox::new(id, &state).input(|input| ...).content(surface) を描画します。input ビルダーは、そのフレーム、名前、プレースホルダー、InputStyles を管理します。名前付きの ComboboxList は ComboboxOption の子を visible_indices(cx) の順序で含み、 必要に応じて ComboboxGroup::new(id, &state, label) のラッパーの内側に置きます。グループ 名は visible_groups(cx) で、一致する項目のインデックスは visible_group_indices(Some(label), cx) で取得します。None はグループ化されていない項目を返します。各グループは 名前付きのネイティブの Group と Heading を提供し、.heading(...) はその見出しにスタイルを適用します。 空のグループは表示されなくなり、見出しはキーボードナビゲーションに含まれません。リストには 高さの上限を与え、空の場合のテキストはリストの外に置いてください。

操作結果
ポインターまたは矢印キーで閉じた input を開くすべてのオプションを表示し、最初に選択済みの、または有効な選択肢をハイライトします
入力確定値を変えずに候補を絞り込みます
Up / Downグループをまたいで有効な結果を移動します
Enter / 結果のクリック(単一モード)1 つの選択肢を確定し、候補を閉じてそのラベルを復元します
Enter / 結果のクリック(複数モード)クエリと候補を開いたまま、その選択肢をトグルします
Escape、Tab、ブラー、または外側の押下下書きを終了します。単一モードではラベルを復元し、複数モードではクエリをクリアします

Tab ストップになるのはクエリだけです。選択済みのチップは通常の アプリケーションの Button で描画し、ユーザーによる削除には remove_value(value, window, cx) または clear(window, cx) を呼び出します。これらの操作は変更後の選択を通知し、 フォーカスをクエリに戻し、無効なコントロールや IME の入力中の状態では拒否されます。 set_disabled はポップアップを閉じ、通常の入力をブロックします。set_query は フォーカスされた下書きを開始します。マークされたテキストは候補のナビゲーションや確定より優先され、 Escape はまず入力中の状態を解除します。ヘッドレスのチェックでは、デスクトップの IME の 動作は確認できません。

set_items(items, window, cx) は Change イベントなしでソース項目を置き換えます。 現在の選択は安定した値に追従し、存在しなくなった値や新たに無効になった値は 削除されます。アクティブなクエリのテキスト、フォーカス、ネイティブの入力中の状態は保持されます。閉じた 単一選択では表示ラベルが更新されます。取得、読み込み、 リクエストの順序、エラーはアプリケーションが管理し、ネットワークコントローラーはインストールされません。

ネイティブのセマンティクスには、ComboBox のクエリ、expanded 状態、名前付きのグループ、 確定した選択値、および複数モードでの複数選択可能なリストボックスが含まれます。固定された GPUI API では、input から兄弟のリストへの active-descendant の 関係を表現できません。自由形式の確定値は提供されません。結果は Command のランク付けされた順序どおりのマッチングを使用します。 設定のサンプルは Dialog 内で単一のプリセットを保持します。カタログの Selection ビューは、グループ化された複数のターゲット、チップの削除、ローカルの ソース更新を、2 つ目の input や選択エンジンなしで示します。