GPUI Deck

Typography

明示的なレベルを持つ名前付きの見出し、ネイティブなインラインコードのテキストランを持つ段落、独立して名前付けされるコード要素。

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

typography.rs は、Heading、 Paragraph、InlineCode を 1 つのプレゼンテーションレシピとして提供します。GPUI がテキストのシェーピング、 レイアウト、描画を担います。アプリケーションは、コンテンツ、アウトラインのレベル、フォントの 選択、利用可能な幅、周囲の余白を用意します。

Heading::new("help-title", "Help", 2, palette);

Paragraph::new("state-ownership", palette)
    .text("The application retains ")
    .code("DialogState")
    .text(" and ")
    .code("InputState")
    .text(" while panels are closed.");

InlineCode::new(
    "help-source",
    "crates/base/examples/two_styles.rs",
    palette,
);

Heading::new には、正のネイティブな見出しレベルが必要です。その可視のテキストが、 完全なアクセシブルな名前にもなります。レベルはコンテンツのアウトラインから選んでください。 レベルを変えると、デフォルトの視覚的なサイズとは独立して、セマンティックな階層が変わります。どのレベルも 1.25 * palette.font_size の semibold から始まります。 異なる視覚的なスケール、色、余白には、通常の Styled による調整を使用してください。

Paragraph::text と Paragraph::code は、渡されたテキストを順に追加し、 空白を挿入したりマークアップを解釈したりしません。句読点と空白は テキストの区間に含めてください。1 つのネイティブな StyledText が段落全体を整形するため、 インラインコードも同じテキストの流れと行の折り返しの一部のままです。段落の デフォルトは、通常の折り返し、パレットの本文サイズと前景色、フォントサイズの 1.5 倍の 行の高さです。親には利用可能な幅を与え、長いテキストのために高さは自動のままにしてください。 レシピは、切り詰め、固定の高さ、独立したスクロールを追加しません。オーバーフローは、周囲の Sheet/ScrollArea のコンテンツが担います。

段落はネイティブな Paragraph セマンティクスを公開し、連結された全文を 1 つのアクセシブルな名前とします。そのコード範囲には、ネイティブなテキストランのスタイルとして、コンシューマーのコードフォントと 背景が使われます。GPUI は、スタイル付きの範囲ごとのアクセシビリティのロールを公開しないため、これらの範囲は個別の Code ノードを作りません。 コードが独自の要素を必要とする場合は、InlineCode が、個別に名前付けされた ネイティブな Code 要素を提供します。コードが文章の中に属する場合は、Paragraph::code を使用してください。 3 つの型はすべて静的なテキストで、フォーカスストップやキーボードアクションを追加しません。

コンシューマーの palette.code_font_family が、要求するコードフォントを選びます。 サンプルは、Linux では DejaVu Sans Mono、Windows では Consolas、macOS では Menlo を要求します。 アプリケーションは、自身の環境に適したフォントを用意してください。 Styled は、各要素のレイアウトとテキストのプレゼンテーションを制御します。Paragraph のコード 範囲は、本文のテキストの中で、明示的なコードフォントと背景のスタイルを保ちます。 表示サイズを変えても、Heading のネイティブなレベルや、アクセシブルな名前に使われる テキストは変わりません。

どちらの外観も、Help タブでこのレシピを使用しています。レベル 2 の Help の見出しが、 既存のレベル 3 の Accordion の見出しの上にあり、パネルには、保持されるアプリケーションの状態についての文章と、 独立して名前付けされたソースの識別子が含まれます。 キーボードヘルプのポップアップには、既存の Breadcrumb のアクションと Kbd のヒントを保ったまま、簡潔な見出しが加わります。より長い説明は、Sheet の スクロールする本体の中にあります。デバッグ描画時のスタック使用量を抑えるため、コンシューマーのビルダーは小さなヘルパー関数に分けています。

このレシピは、テキストのプレゼンテーションとメタデータを提供します。Markdown の解析、シンタックス ハイライト、コードのコピー、テキストの編集、複数行の Code Block の構成は、 そのスコープの外です。保持される状態や、2 つ目のテキストレンダラーは導入しません。