GPUI Deck

Code Block

読み取り専用の複数行コード、全文を正確にコピーする Copy アクション、キーボードで操作できる、範囲が制限された 2 軸のスクロール。

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

code_block.rs は、読み取り専用の 複数行コードを、既存の Button、GPUI のクリップボード、ScrollArea と合成します。

CodeBlock::new(
    "session-configuration",
    configuration_json,
    "Session configuration",
    &configuration_scroll,
    &configuration_focus,
    palette,
);

ScrollHandle と FocusHandle は、アプリケーションで保持してください。渡されたラベルは Copy ボタンの横に表示され、そのアクセシブルな名前は Copy {label} です。 コードはネイティブな Code セマンティクスを公開し、その完全な元のテキストをアクセシブルな 名前とします。ビューポートはキーボードのフォーカス対象で、Copy は 既存のポインター、Enter、Space、フォーカスの動作を持つ通常の Button のままです。 レシピは、テキスト入力ノード、エディターの状態、選択モデルを追加しません。

デフォルトのフレームは高さ 12 rem で、利用可能な幅いっぱいに広がります。そのヘッダーは、 範囲が制限されたコードのビューポートの外にあります。Styled でフレームをカスタマイズできます。ScrollArea が 長い本体や長い行を収められるように、高さと幅には上限を設けたままにしてください。コードには パレットのコードフォントと前景色を使用します。GPUI ネイティブのテキストレイアウトが、 渡された行をソフトラップなしで表示し、水平方向と垂直方向のオーバーフローは 同じ ScrollArea の中に収まります。レシピは、コードの解析も、シンタックス ハイライト、行番号、仮想化された描画の追加も行いません。

Copy は、画面外のコンテンツや空文字列も含め、渡された文字列全体を App::write_to_clipboard に送ります。 空白、改行コード、末尾の改行のトリム、正規化、置換は行いません。LF、CRLF、Unicode のコンテンツは コピーされるペイロードにそのまま保持されます。可視のテキストは GPUI が整形します。レシピは、 追加のタブストップのポリシーや、見た目上の CRLF の正規化を定義しません。 コピー済みの状態を示す別のタイマーや、自動的なアナウンスはありません。

コードのビューポート自体にフォーカスがあるとき、修飾キーなしの矢印キーはそれぞれの 軸でスクロールし、Page Up/Down は縦にスクロールし、Home は左上に戻り、 End は右下に移動します。オフセットはコンテンツのスクロール範囲内に収まります。 Tab と Shift-Tab は通常の移動を維持し、Escape は囲んでいるモーダルが利用でき、 修飾キーはアプリケーションに任されます。Copy ボタンの キーイベントは Button の契約に従います。コード上でのホイール操作は、端に達しても そのビューポート内にとどまります。親の Sheet を動かすには、その外側でスクロールしてください。

どちらの外観でも、CodeBlock は Help の State ownership パネルで、 ソースパスの識別子の前に使われています。コンシューマーは、保持されている現在の設定を、既存の serde_json の依存関係で JSON としてシリアライズします。これは表示とコピーのための スナップショットであり、コピーしても設定を解析したり適用したりしません。サンプルでは、 コンシューマーのビルダーをメインの描画関数から分離し、既存の Sheet、フォーカスの封じ込め、親のスクロールを再利用しています。Typography は引き続き 文章と短いインラインコードを扱い、CodeBlock は範囲が制限された複数行のプレゼンテーションを担います。