データグリッド

アプリケーション向けのスプレッドシート。セルの編集、範囲の選択、レコードの絞り込みを行い、先頭列の固定とリアルタイム集計で数千行を扱えます。

Renewals

Total Results10,000 rows

Use arrow keys to navigate, Shift and arrows to select cells, and Enter or F2 to edit. Copy and paste cells with your keyboard. Column headings sort; column separators resize with arrow keys.

Northwind Freight
Owen Park
Latin America
Closed won
40
$9,600
49%
Lumen Freight
Tyler Hayes
Europe
Closed won
105
$37,800
90%
Cedar Freight
Tyler Hayes
Latin America
Proposal
230
$96,600
64%
Brightline Freight
Marcus Johnson
Asia Pacific
Proposal
115
$41,400
78%
Harbor Freight
Daniel Kim
Latin America
Committed
10
$4,200
72%
Pinecrest Freight
Marcus Johnson
Europe
Closed won
470
$169,200
72%
Atlas Freight
Sarah Bennett
Latin America
Discovery
45
$16,200
95%
Summit Freight
Owen Park
Asia Pacific
Negotiation
255
$107,100
93%
Fieldstone Freight
Marcus Johnson
Europe
Discovery
660
$237,600
82%
Evergreen Freight
Marcus Johnson
Latin America
Negotiation
46
$13,800
56%
Meridian Freight
Owen Park
Asia Pacific
Discovery
119
$42,840
73%
Redwood Freight
Daniel Kim
Europe
Committed
192
$80,640
90%
Westbridge Freight
Tyler Hayes
North America
Proposal
265
$63,600
41%
Sum3.3M
Sum$1.1B
Avg67.5%
A1Count 1

インストール

CLI で無料の Data Grid を追加できます。使用する BoardUI のコントロールと内部データヘルパーも含まれています。

ダークモード対応:この コンポーネント はBoardUIのセマンティックトークンに合わせて自動で切り替わります。 テーマスイッチの設定.

CLIがコンポーネントのソースと内部の依存ファイルをプロジェクトにコピーし、必要なnpmパッケージをインストールします。

npx boardui@latest add data-grid

共有UIパッケージや独自のインポートエイリアスを使う場合は、 インストールパスの設定 をCLIの実行前に設定してください。コピー&ペーストの例は、標準のインポートを使います。

列と編集

型付きの値を渡す先は columns、独自の data、および一意で安定した getRowId。指定するものは onDataChange で編集を有効にします。テキスト、数値、選択肢のエディターは BoardUI の入力とセレクトを再利用します。範囲の指定には min そして、 max、または値の拒否に validate.

利用条件 format でセル表示を、 formatSummary で合計、平均、件数をフッターに表示できます。設定するものは editable= を列ごとに設定できます。書式設定は表示だけを変更し、編集、コピー、書き出しには元の値を使います。

const columns: DataGridColumn<Account>[] = [ { key: "account", header: "Account", width: 220, validate: (value) => String(value).trim() ? undefined : "Account cannot be empty." }, { key: "stage", header: "Stage", type: "select", options: ["Discovery", "Proposal", "Closed won"] }, { key: "seats", header: "Seats", type: "number", min: 0, summary: "sum" }, { key: "arr", header: "ARR", type: "number", min: 0, editable: false, summary: "sum", formatSummary: (value) => `$${value.toLocaleString("en-US")}` },]; // Omit onDataChange to make every cell read-only.<DataGrid aria-label="Accounts" data={data} columns={columns} getRowId={getRowId} />

検索、フィルター、書き出し

全列を検索し、見出しをクリックして昇順、降順、元の順序を切り替えるか、値の完全一致で絞り込めます。選択肢のある列はフィルターメニューに自動で表示されます。追加するものは filterable を他の列に追加します。列の非表示、境界線による幅の変更、標準とコンパクトな行の切り替えができます。

最初の表示列は行番号の横に固定されます。狭い画面では他の列と一緒にスクロールし、すべてのセルにアクセスできます。行のチェックボックスはセル範囲とは独立してレコードを選択し、ヘッダーのチェックボックスは絞り込み後の全行を切り替えます。行を選択すると件数と削除、コピー、書き出しの操作がツールバーに表示されます。コピーはタブ区切り、書き出しは CSV で、どちらも表示列と選択された表示レコードを使用します。削除に必要なものは onDataChange が必要で、元に戻すこともできます。選択を解除すると検索と表示のコントロールに戻ります。集計は常に絞り込み後のレコードを反映します。

キーボードとクリップボード

Tab でグリッドに入り、矢印キーでセル間を移動します。Shift を押しながら範囲を広げるか、マウスでセルをドラッグします。Home と End は行内を移動し、⌘ または Ctrl を加えると先頭または末尾のレコードに移動します。Page Up と Page Down は表示領域単位で移動します。⌘/Ctrl+A は全セルを選択します。

選択肢のあるセルを選ぶとドロップダウンが現れ、シェブロンをクリックして値を選択できます。ダブルクリック、Enter、F2 でセルのエディターが開きます。Enter は保存して下へ、Shift+Enter は上へ移動します。Tab は保存して次のセルへ移動し、Escape はキャンセルします。範囲をコピーし、通常のショートカットでタブ区切りの表データを貼り付けられます。無効な値があると貼り付け全体を拒否します。元に戻す・やり直すはセル編集、貼り付け、行削除に対応し、グリッドのマウント中は最大 100 操作を保持します。

各グリッドに指定するものは aria-label。右から左に読む領域を囲むには DirectionProvider。固定列、メニュー、左右の矢印キーは読む方向に従います。

10,000 行を小さな表示領域に

上のプレビューには実際のレコードが 10,000 件あります。固定高さの仮想化により、表示領域内とその周辺の行だけをマウントします。ヘッダーと集計はスクロール領域の外にあり、スクロール中は段階的なぼかしで上端を柔らかくします。設定するものは height で表示領域の高さを変更します。

検索、並べ替え、フィルター、集計は渡されたデータを使ってブラウザーで実行されます。レコードが移動してもセルの選択と編集は安定した行 ID に追従します。変更を永続化する場所は onDataChange ハンドラーで永続化してください。グリッドを再マウントするには新しい React key を使って、別のデータセットへの切り替え時に表示状態と編集履歴をリセットします。

右から左と読み取り専用

利用条件 DirectionProvider で読む方向を設定します。この読み取り専用の例では先頭列を右に固定し、左右のキーボード操作を反転します。列ラベルやレコードの値には任意の言語を使えます。

Total Results2 rows

Use arrow keys to navigate, Shift and arrows to select cells, and Enter or F2 to edit. Copy and paste cells with your keyboard. Column headings sort; column separators resize with arrow keys.

نورث ويند
أوروبا
40
لومن
آسيا
105
Sum145
A1Count 1Read-only