ModaGrid — データグリッド
ヘッドレスグリッド — 仮想スクロール・ピボット・ツリー・Excel。
React・Vue・Svelte・素のJSどこでも同じように動くヘッドレスデータグリッドライブラリ。
ソート・フィルタ・検索・ページング・編集などすべてのデータロジックを純粋TypeScriptコア(GridCore)に置き、各フレームワークアダプタは薄いレンダリング層のみ。フレームワークが違っても動作は常に同じです。
他グリッドでは有償(Enterprise)のSetフィルタ、グループ化+集計、クリップボード、範囲選択をMITで無料提供。
ライブデモ
CDNから読み込んだ実際のコアで動作します。ソート・複合ソート・演算子/Setフィルタ・検索・ページング・仮想スクロール・セル/範囲/行選択・インライン編集・Undo/Redo・クリップボード・カラムリサイズ/再配置/固定/非表示・行グループ化と集計・固定行・合計・状態保存/復元・行ドラッグ・行状態追跡(I/U/Dマーキング・差分保存)をすべて試せ、ツリーデータとサーバーサイド無限スクロールもタブで切替できます。グリッド下のパネルには現在の設定とAPI呼び出しを再現するコードがリアルタイム表示されます。
ダブルクリックまたは文字入力で編集 · ドラッグで範囲選択 · ⌘/Ctrl+C·V コピー/貼付 · ⌘/Ctrl+Z·Y 元に戻す/やり直し · 矢印/Shift+矢印で移動と拡張 · ⠿ハンドルで行ドラッグ · ヘッダー右端で幅調整 · ヘッダードラッグで順序変更
環境別パッケージ
| 使用環境 | パッケージ | 備考 |
|---|---|---|
| React | @moda-grid/react | DataGridコンポーネント + useGridCoreフック, renderCell/renderEditor拡張 |
| Vue 3 | @moda-grid/vue | useGrid + DataGrid, 列別カスタムセル・エディタスロット |
| Vue 2.7 | @moda-grid/vue2 | Vue 3と同じComposition API |
| Svelte 5 | @moda-grid/svelte | runes基盤createGridStore + DataGrid |
| 純JS / CDN | moda-grid.js | ビルドなし<script>一行、window.ModaGrid |
| フレームワークなし | @moda-grid/core | ヘッドレスGridCore直接使用 |
npmでインストール
npm i @moda-grid/react # Reactnpm i @moda-grid/vue # Vue 3npm i @moda-grid/vue2 # Vue 2.7npm i @moda-grid/svelte # Svelte 5npm i @moda-grid/core # ヘッドレスコアのみCDNでそのまま使う
https://grid.modaolive.com/moda-grid.jshttps://grid.modaolive.com/style.css3ステップで開始
- 1
パッケージインストール
npm i @moda-grid/reactのようなアダプタをインストールするか、CDN <script>一行でコアをロードします。
- 2
列 + データ
columnsにfield・headerだけでも動作します。filterable・cellEditor等は必要な時に追加します。
- 3
レンダリング
アダプタは<DataGrid>一つで完了。コア直接使用時はsubscribe + getSnapshotで接続します。
// npm i @moda-grid/react
import { DataGrid, useGridCore } from "@moda-grid/react";
import "@moda-grid/react/styles.css";
const columns = [
{ field: "id", header: "ID", width: 60 },
{ field: "name", header: "名前", filterable: true },
{ field: "role", header: "役割",
renderCell: (value) => <span className={`badge role-${value}`}>{value}</span> },
];
function App() {
const { grid, snapshot } = useGridCore({ columns, data: users });
return (
<>
<input onChange={(e) => grid.setSearch(e.target.value)} />
<button onClick={() => grid.exportToCsv({ filename: "users.csv" })}>
CSVエクスポート
</button>
<DataGrid grid={grid} columns={columns}
height={480} rowHeight={37}
selectionMode="multi-cell" columnController />
</>
);
}すべてのミューテーションは内部でスナップショットを再計算して購読者に通知します。スナップショットはメモ化され、React useSyncExternalStoreとそのまま整合します。
機能別の使い方 — 何を使えばいいか
アダプタはprop・オプション1行で有効化し、コアのみの場合はAPIを直接呼びます。
参照・探索
| 機能 | 有効化方法 (オプション/prop/入力) | コアAPI |
|---|---|---|
| ソート | デフォルトon — ヘッダークリック | toggleSort(field) / setSort(field, "asc") |
| 複数ソート | Shift + ヘッダークリック | toggleSort(field, true) |
| カラムフィルタ | ColumnDef.filterable: true + filterType: "text"|"number"|"date" | setFilter(field, { operator, value, valueTo? }) |
| Setフィルタ (Excel式) | filterType: "set" | setFilter(field, { operator: "set", values: [...] }) |
| グローバル検索 | 外部inputを接続 | setSearch(text) |
| ページング | GridOptions.pageSize | setPage(pageIndex, pageSize?) |
選択・編集
| 機能 | 有効化方法 (オプション/prop/入力) | コアAPI |
|---|---|---|
| セル選択モード | selectionMode: "single-cell"|"multi-cell"|"row" | setSelectionMode(mode) |
| 範囲追跡選択 | selectionMode="multi-cell" + rangeTracking: "identity" | ソート・フィルタ後もセル範囲を識別子で追跡 |
| アクティブセル・範囲 | クリック / ドラッグ / 矢印キー・Shift+矢印 | setActiveCell(r,c) / setCellRange / navigateCell |
| 行選択 + チェックボックス | rowCheckboxes prop | toggleRowSelection(id) / toggleAllRows() |
| インライン編集 | editable + cellEditor: "text"|"number"|"select"|"date"|"custom" | startEditing / updateEditValue / commitEditing / cancelEditing |
| 入力検証 | ColumnDef.validate(value, row) | 失敗時 snapshot.editError |
| 元に戻す・やり直し | 自動記録 (undoLimit デフォルト100) | undo() / redo() / canUndo() |
| コピー・ペースト (TSV) | アダプタが⌘/Ctrl+C·Vを自動処理 | getSelectionTsv() / pasteTsv(tsv) |
| 選択集計ステータスバー | statusBar prop (デフォルトon) | snapshot.selectionAggregates |
| 検索・置換 | — | findCells / findNext / replaceAll(find, repl) |
| セル・ヘッダ右クリックメニュー | contextMenu / headerContextMenuオプション (プリセット: defaultContextMenuItems) | openContextMenu / runContextMenuItem / snapshot.contextMenu |
行ステータス追跡 (I/U/D)
| 機能 | 有効化方法 (オプション/prop/入力) | コアAPI |
|---|---|---|
| 行追加 | — | addRows(rows) / importCsv(csv) → Iマーク |
| 修正追跡 | 編集・pasteTsvで自動マーク | → U状態 (I行は修正してもIのまま) |
| 削除マーク・復元 | — | deleteRowsByIds(ids) → D / restoreRowsByIds(ids) |
| ステータス列表示 | rowStatus prop — 左端のステータス列 | snapshot.rowStates + mg-row-I/U/D CSSクラス |
| 変更分の保存・取消 | — | validateChanges() → getChanges() → commitChanges() / clearChanges() |
列・行・描画
| 機能 | 有効化方法 (オプション/prop/入力) | コアAPI |
|---|---|---|
| カラムリサイズ | resizable (デフォルトon) — ヘッダー端をドラッグ | setColumnWidth(field, px) |
| 自動幅 | 端をダブルクリック | autoSizeColumn / autoSizeAllColumns |
| カラム再配置 | reorderable (デフォルトon) — ヘッダードラッグ | reorderColumn(from, to) |
| カラム固定 | ColumnDef.pinned: "left"|"right" | setColumnPinned(field, pinned) |
| カラム表示・非表示 | columnController prop (列 ▾ ポップオーバー) | setColumnVisible / setAllColumnsVisible |
| 多段階グループヘッダ | ColumnDef.group + GridOptions.columnGroups | snapshot.headerGroups |
| レイアウトリセット | — | resetColumnLayout() |
| 行ドラッグ&ドロップ | ColumnDef.rowDrag: true | begin/update/endRowDrag · moveRow |
| 可変高スクロールアンカリング | 自動 | 高さが変わる行もスクロール位置を維持 |
| 編集セッション保護 | 自動 | ソート・フィルタ・再描画中も編集を維持 |
| 固定行 | pinnedTopRows / pinnedBottomRowsオプション | setPinnedTopRows / setPinnedBottomRows |
| 総合計 (tfoot) | ColumnDef.aggregationFn: "sum"|"avg"|"min"|"max"|"count" | snapshot.grandTotals |
| セル結合 | ColumnDef.merge: "row"|"col"|"both" | getCellSpan(row, col) → { rowSpan, colSpan, hidden } |
| 状態保存・復元 | — | getState() / applyState(saved) |
| テーマ | --grid-*変数 / .grid-theme-dark | cellClass / rowClass 条件付き |
大容量・階層・エクスポート
| 機能 | 有効化方法 (オプション/prop/入力) | コアAPI |
|---|---|---|
| 仮想スクロール | アダプタ: height+rowHeight | virtualScroll + handleScroll(scrollTop) |
| 行グループ化 + 集計 | — | setGroupBy(["dept"]) + ColumnDef.aggregationFn |
| ピボットテーブル | pivot prop — ディメンション+測定値 | setPivot({ rows, columns?, values: [{field, agg}] }) / isPivot() |
| ツリーデータ | treeData prop | treeData: { childrenKey } または { getParentId } |
| サーバサイド無限スクロール | serverSide prop | serverSide: { dataSource, cacheBlockSize } / refreshServerRows |
| CSVエクスポート | — | exportToCsv({ filename, visibleColumnsOnly, selectedRowsOnly }) |
| Excel・PDFエクスポート | — | exportToXlsx({ filename, styled }) / exportToPdf / print() |
よく使うレシピ
コピーしてすぐ使えるコードスニペットです。
Setフィルタ (チェックリスト)
カラム固有値をチェックリストでフィルタ — Excel同UX
// カラムにfilterType指定
{ field: "role", header: t.roleL, filterable: true, filterType: "set" }
grid.getUniqueValues("role"); // ["admin","editor","viewer","guest"]
grid.setFilter("role", { operator: "set", values: ["admin","editor"] });
grid.setFilter("role", null); // 全選択 = フィルタ解除CSVエクスポート
現在の表示状態そのままエクスポート。UTF-8 BOMでExcel文字化けなし
grid.exportToCsv({
filename: "users.csv",
visibleColumnsOnly: true, // 非表示列を除外 (デフォルト)
selectedRowsOnly: false, // 選択行のみ出力する時true
});変更分のみサーバ保存 (I/U/D)
追加・修正・削除をマーク追跡し変更分のみ送信。rowStatus propで状態列
// I = addRows/importCsv · U = 編集/pasteTsv · D = deleteRowsByIds (I行は即削除)
grid.addRows([{ id: "new-1", name: t.newEmp }]);
grid.deleteRowsByIds(["3", "7"]); // Dマーク — commitまで画面に残る
grid.restoreRowsByIds(["3"]); // Dマーク解除
async function save() {
const errors = grid.validateChanges(); // I/U行のrequired/validate検査
if (errors.length) return console.warn(errors);
await fetch("/api/users", {
method: "POST",
body: JSON.stringify(grid.getChanges()), // { inserted, updated, deleted }
});
grid.commitChanges(); // D除去 + マーク初期化
}
// マークのみ取消(画面復帰)はgrid.clearChanges()状態保存・復元
ソート・フィルタ・検索・ページング・グループ化・列レイアウトをlocalStorageに
// 保存 — 直列化可能なオブジェクトが返る
localStorage.setItem("grid", JSON.stringify(grid.getState()));
// 復元 — 存在しない列参照は無視されスキーマ変更に安全
grid.applyState(JSON.parse(localStorage.getItem("grid")!));
// 部分適用も可能
grid.applyState({ sortState: saved.sortState });サーバサイド無限スクロール
未ロードブロックに達するとgetRows自動呼出。ソート・フィルタはサーバパラメータへ
const grid = new GridCore({
columns,
data: [], // サーバモードでは無視
serverSide: {
cacheBlockSize: 50,
dataSource: {
async getRows({ startRow, endRow, sortModel, filterModel }) {
const res = await fetch(`/api/rows?start=${startRow}&end=${endRow}`);
return res.json(); // { rows, lastRowIndex? }
},
},
},
virtualScroll: { rowHeight: 37, viewportHeight: 480 },
});
grid.refreshServerRows(); // キャッシュ破棄 + 再要求ツリーデータ
親子階層を展開/折り畳みツリーに。2種のデータ形態対応
// nested — 行内に子配列
new GridCore({ columns, data, treeData: { childrenKey: "children" } });
// flat — parentIdで連結 (親がフィルタされた行はルートに昇格)
new GridCore({ columns, data,
getRowId: (r) => r.id,
treeData: { getParentId: (r) => r.parentId },
});
grid.toggleTreeExpanded(rowId); // 展開/折りたたみカスタムセル・エディタ (React)
ColumnDef拡張でJSXレンダラとエディタを列に直接指定
{
field: "role",
header: t.roleL,
renderCell: (value) => <span className={`badge role-${value}`}>{value}</span>,
renderEditor: (ctx) => (
<select value={ctx.value} onChange={(e) => ctx.setValue(e.target.value)} />
),
}
// Vueは#cell-{field} / #editor-{field}スロット、Svelteはcell/editorスニペットグループ化 + 集計
フィールドでグループ化しaggregationFn列の合計・平均をグループ行に
{ field: "age", aggregationFn: "avg" } // 集計対象を指定
grid.setGroupBy(["dept", "role"]); // 多段階グループ化
grid.expandAllGroups(); // 全て展開
grid.collapseAllGroups(); // 全て折りたたむ
// snapshot.grandTotalsに全体合計も自動計算セル書式・カスタム値
表示文字列変換と値抽出は列オプションで
{
field: "salary",
header: t.salaryH,
valueGetter: (row) => row.pay.annual, // ネスト値抽出
formatter: (v) => `${Number(v).toLocaleString()}ウォン`, // 表示変換
cellClass: (p) => (p.value > 5000 ? "text-red-500" : ""), // 条件付きクラス
}商用グリッドは有料、moda-gridは無料
Setフィルタ・グループ化・集計・クリップボード・範囲選択・ピボットはAG GridではEnterprise(有料)専用です。moda-gridはMITライセンスで全て無料です。
ソース・ドキュメント
github.com/park-taejoon/moda-grid-releases- 開始・プラットフォーム別ガイド(React/Vue 3/Vue 2.7/Svelte/Vanilla)
- 機能別ガイド — ソート・フィルタ・編集・仮想スクロール・サーバサイド等
- GridCoreヘッドレスAPIリファレンス
使い方
ヘッドレスグリッド — 仮想スクロール・ピボット・ツリー・Excel。