ModaGrid — データグリッド

ヘッドレスグリッド — 仮想スクロール・ピボット・ツリー・Excel。

React・Vue・Svelte・素のJSどこでも同じように動くヘッドレスデータグリッドライブラリ。

ソート・フィルタ・検索・ページング・編集などすべてのデータロジックを純粋TypeScriptコア(GridCore)に置き、各フレームワークアダプタは薄いレンダリング層のみ。フレームワークが違っても動作は常に同じです。

他グリッドでは有償(Enterprise)のSetフィルタ、グループ化+集計、クリップボード、範囲選択をMITで無料提供。

無料 (MIT)React · Vue 3 · Vue 2.7 · Svelte 5 · VanillaヘッドレスコアTypeScript

ライブデモ

CDNから読み込んだ実際のコアで動作します。ソート・複合ソート・演算子/Setフィルタ・検索・ページング・仮想スクロール・セル/範囲/行選択・インライン編集・Undo/Redo・クリップボード・カラムリサイズ/再配置/固定/非表示・行グループ化と集計・固定行・合計・状態保存/復元・行ドラッグ・行状態追跡(I/U/Dマーキング・差分保存)をすべて試せ、ツリーデータとサーバーサイド無限スクロールもタブで切替できます。グリッド下のパネルには現在の設定とAPI呼び出しを再現するコードがリアルタイム表示されます。

ダブルクリックまたは文字入力で編集 · ドラッグで範囲選択 · ⌘/Ctrl+C·V コピー/貼付 · ⌘/Ctrl+Z·Y 元に戻す/やり直し · 矢印/Shift+矢印で移動と拡張 · ⠿ハンドルで行ドラッグ · ヘッダー右端で幅調整 · ヘッダードラッグで順序変更

CDNからmoda-gridコアを読み込み中…

環境別パッケージ

使用環境パッケージ備考
React@moda-grid/reactDataGridコンポーネント + useGridCoreフック, renderCell/renderEditor拡張
Vue 3@moda-grid/vueuseGrid + DataGrid, 列別カスタムセル・エディタスロット
Vue 2.7@moda-grid/vue2Vue 3と同じComposition API
Svelte 5@moda-grid/svelterunes基盤createGridStore + DataGrid
純JS / CDNmoda-grid.jsビルドなし<script>一行、window.ModaGrid
フレームワークなし@moda-grid/coreヘッドレスGridCore直接使用

npmでインストール

npm i @moda-grid/react # React
npm i @moda-grid/vue # Vue 3
npm i @moda-grid/vue2 # Vue 2.7
npm i @moda-grid/svelte # Svelte 5
npm i @moda-grid/core # ヘッドレスコアのみ

CDNでそのまま使う

https://grid.modaolive.com/moda-grid.js
https://grid.modaolive.com/style.css

3ステップで開始

  1. 1

    パッケージインストール

    npm i @moda-grid/reactのようなアダプタをインストールするか、CDN <script>一行でコアをロードします。

  2. 2

    列 + データ

    columnsにfield・headerだけでも動作します。filterable・cellEditor等は必要な時に追加します。

  3. 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.pageSizesetPage(pageIndex, pageSize?)

選択・編集

機能有効化方法 (オプション/prop/入力)コアAPI
セル選択モードselectionMode: "single-cell"|"multi-cell"|"row"setSelectionMode(mode)
範囲追跡選択selectionMode="multi-cell" + rangeTracking: "identity"ソート・フィルタ後もセル範囲を識別子で追跡
アクティブセル・範囲クリック / ドラッグ / 矢印キー・Shift+矢印setActiveCell(r,c) / setCellRange / navigateCell
行選択 + チェックボックスrowCheckboxes proptoggleRowSelection(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.columnGroupssnapshot.headerGroups
レイアウトリセット—resetColumnLayout()
行ドラッグ&ドロップColumnDef.rowDrag: truebegin/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-darkcellClass / rowClass 条件付き

大容量・階層・エクスポート

機能有効化方法 (オプション/prop/入力)コアAPI
仮想スクロールアダプタ: height+rowHeightvirtualScroll + handleScroll(scrollTop)
行グループ化 + 集計—setGroupBy(["dept"]) + ColumnDef.aggregationFn
ピボットテーブルpivot prop — ディメンション+測定値setPivot({ rows, columns?, values: [{field, agg}] }) / isPivot()
ツリーデータtreeData proptreeData: { childrenKey } または { getParentId }
サーバサイド無限スクロールserverSide propserverSide: { 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。

data grid

関連ツール