GPUI Deck

Table

共有される固定/可変の列、ヘッダー/本体/フッターの構造、ネイティブの行/セルのセマンティクス、行の選択、ヘッダーのソートメタデータを提供します。

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

Table は列を一度だけ定義し、それをヘッダー、本体、フッターに適用します。 各行は、列ごとにちょうど 1 つのセルを提供しなければなりません。安定したトラックには固定幅を、 残りの幅の分配には正の可変の重みを使用します。

Table::new(
    "sessions",
    [TableColumn::fixed(px(180.)), TableColumn::flex(1.)],
)
.accessibility_label("Sessions")
.w_full()
.header(
    TableRow::new("sessions-header")
        .cell(TableCell::new("session-heading").p_2().child("Session"))
        .cell(TableCell::new("date-heading").p_2().child("Date")),
)
.row(
    TableRow::new("session-1")
        .cell(TableCell::new("session-1-name").row_header(true).p_2().child("Workshop"))
        .cell(TableCell::new("session-1-date").p_2().child("2026-11-09")),
)
.caption(TableCaption::new("sessions-caption").child("Scheduled sessions"))

header と footer はそれぞれ 1 行を受け付けます。本体の行は row または rows で追加します。TableRow::cells はイテレーターも受け付けます。空の本体も有効なので、 アプリケーションは、空の状態の説明を表の横に描画できます。

すべてのパーツが Styled を実装しています。セルとキャプションは任意の子要素を受け付けます。 アプリケーションはセルに既存の Button や Checkbox を置けます。構造的な テーブルのパーツは Tab ストップを追加せず、それらのコントロールの操作を妨げません。 Table は行の水平レイアウトを管理します。行に水平のパディング、マージン、隙間を追加するのではなく、 セルの内側に余白を設けてください。セルのスタイルは内側のコンテンツ面に適用されるため、 ヘッダーと本体のパディングが異なっても、共有される外側の列幅は保たれます。

パーツネイティブのセマンティクス
TableTable、行数、列数、明示的なアクセシブルなラベル
ヘッダー/本体/フッターRowGroup
行Row と 0 始まりのインデックス
ヘッダーセル行/列のインデックスを持つ ColumnHeader
通常のセル行/列のインデックスを持つ Cell
row_header(true) を持つセルRowHeader。ただし列ヘッダーの行に属する場合を除きます
キャプションフォーカスアクションのない Caption

インデックスにはヘッダーとフッターが含まれます。表示されるキャプションは、自動的には テーブルに名前を付けません。accessibility_label を別途指定してください。セルも、表示される内容が名前を提供しない場合に備えて、 明示的なアクセシブルなラベルを受け付けます。

これは、セルのナビゲーションやデータコントローラーを持たない、通常のテーブルです。行や 列のスパン、固有の列サイズの自動調整、ソート、フィルタリング、ページネーション、 選択の管理、仮想化は提供されません。TableRow::selected と TableCell::sort_direction は、アプリケーションが管理する選択とソートを ネイティブのメタデータに反映しますが、データ操作は行いません。データ操作は、実際のアプリケーションが必要とするときに、 この構造の上に組み合わせてください。

コピーして使える DataTable レシピは、テキストの フィルタリング、単一列のソート、ページネーション、ページ/行のチェックボックスによる選択、列の 表示切り替え、空の状態からの復帰、安定した ID による行アクションを追加します。ネイティブのサンプルは、これを使って録画プリセットを閲覧して適用します。 そのクエリとページの状態は、Table の外にあるアプリケーションが管理します。