Renewals
インストール
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 で読む方向を設定します。この読み取り専用の例では先頭列を右に固定し、左右のキーボード操作を反転します。列ラベルやレコードの値には任意の言語を使えます。