GPUI Deck

Hover Card

ホバーによる遅延表示のリッチプレビュー、タッチの長押しプレビュー、トリガーからカードへのポインター移動、フォーカスを移さないフォーカスプレビュー、閉じる動作に対応します。

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

HoverCard は、Button の通常のアクションに対する、リッチで操作できないプレビューを提供します。 安定したトリガーのフォーカスハンドルを保持し、 HoverCardState::new(&trigger_focus, window, cx) を作成します。利用側を再描画するには State を observe します。任意の .with_delays(open_duration, close_duration) は、マウント前のポインターの 進入と退出の遅延を設定します。デフォルトは 500 ms と 200 ms です。

HoverCard::new("preset-preview", &preview)
    .accessibility_label("Recording preset preview")
    .offset(px(6.))
    .trigger(|button| {
        button
            .accessibility_label("Recording preset. Edit settings")
            .on_click(open_settings)
            .child("Preset: Balanced")
    })
    .content(preview_surface)

トリガーのビルダーは Button のアクションを保持し、その外観を指定します。 State は自身のフォーカスハンドルと無効状態を管理します。プレビューと Button を 連動させるには set_disabled を使用します。HoverCard の Styled メソッドはホストのフレームに 適用されます。アプリケーションが指定するコンテンツには別途スタイルを適用し、既存の Popup のジオメトリには .anchor(...) と .offset(...) を使用してください。

入力動作
ポインターがトリガーに入るフォーカスを移さずに、進入の遅延後に開きます
ポインターがトリガーとカードの両方から出る退出の遅延後に閉じます。ただしトリガーがキーボードフォーカスを保持している場合を除きます
ポインターがカードに入る、またはトリガーに戻る遅延されていた閉鎖をキャンセルします
キーボードフォーカスがトリガーに入るすぐに開きます。フォーカスは Button に残ります
Escape表示中のプレビューを閉じ、現在の進入の間は再表示を抑制します
クリック / Enter / Spaceプレビューを閉じます。Button またはクリックされたコントロールは通常のアクションを実行します
フォーカスの変更 / ウィンドウの非アクティブ化フォーカスを移さずに閉じます

閉じる遅延により、ポインターがトリガーとカードの間の隙間を横切れます。キーボードで開いた プレビューは、ポインターが離れても、ブラーまたは明示的な閉鎖まで残ります。 Escape はフォーカスをその場に残し、別のフレームが描画されたり、同じトリガー内でポインターが動いたりしただけでは カードを再表示しません。新たなトリガーへの進入やキーボードフォーカスで再び表示できます。まだ表示されていない 保留中のプレビューをキャンセルしても、Escape は周囲のサーフェスが利用できる状態のままです。

State のメソッドは is_open、is_disabled、focus_handle、 close(window, cx)、set_disabled(disabled, window, cx) です。明示的な閉鎖は 現在の進入を抑制します。再び有効にすると、次の進入またはフォーカスを待ちます。 アンマウントすると遅延された処理がキャンセルされ、保持されていた表示状態がクリアされます。マウントされた Escape の購読は、そのウィンドウにのみ属します。

Popup は配置、ビューポートへの制限、遅延描画、オクルージョンを管理します。表示される プレビューは Tab ストップを持たない補助的な Tooltip サーフェスであり、フォーカストラップを 開くことはありません。accessibility_label はそのサーフェスに名前を付けます。重要な 情報は、ポインターのプレビューだけでなく、Button のアクセシブルな説明や通常の 移動先でも利用できるようにしてください。インタラクティブなコンテンツは Popover に置きます。タッチにはホバーがありません。トリガーの長押しは Button をアクティブ化せずに すぐにプレビューを開き、次にどこかを押すと閉じます。グローバルな ホバープロバイダーは提供されません。

サンプルは、現在の録画プリセット、録画日、ノートの状態をプレビューします。同じ Button をクリックするか Enter を押すと 設定の Dialog が開き、閉じると Button にフォーカスが戻ります。