ModaGrid — Data Grid
Headless data grid — virtual scroll, pivot, tree, Excel export.
A headless data-grid library that behaves identically in React, Vue, Svelte, and plain JS.
All data logic — sorting, filtering, search, paging, editing — lives in a pure TypeScript core (GridCore); each framework adapter is just a thin rendering layer. Behavior is identical across frameworks.
Features that are paid (Enterprise) in other grids — Set filters, grouping+aggregation, clipboard, range selection — are free under MIT.
Live demo
Runs on the real core loaded from CDN. Try sorting, multi-sort, operator/Set filters, search, paging, virtual scroll, cell/range/row selection, inline editing, Undo/Redo, clipboard, column resize/reorder/pin/hide, row grouping & aggregation, pinned rows, totals, state save/restore, row drag, row status tracking (I/U/D marking, diff save) — plus tree data and server-side infinite scroll via tabs. The panel below the grid shows code reproducing your settings and API calls in real time.
Edit by double-click or typing · drag for range · ⌘/Ctrl+C·V copy/paste · ⌘/Ctrl+Z·Y undo/redo · arrows/Shift+arrows move & extend · ⠿ handle drags rows · header edge resizes · header drag reorders
Packages by environment
| Environment | Package | Notes |
|---|---|---|
| React | @moda-grid/react | DataGrid component + useGridCore hook, renderCell/renderEditor slots |
| Vue 3 | @moda-grid/vue | useGrid + DataGrid, per-column custom cell/editor slots |
| Vue 2.7 | @moda-grid/vue2 | Same Composition API as Vue 3 |
| Svelte 5 | @moda-grid/svelte | runes-based createGridStore + DataGrid |
| Vanilla JS / CDN | moda-grid.js | One <script>, no build — window.ModaGrid |
| No framework | @moda-grid/core | Use headless GridCore directly |
Install via 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 # Headless core onlyUse via CDN
https://grid.modaolive.com/moda-grid.jshttps://grid.modaolive.com/style.cssGet started in 3 steps
- 1
Install package
Install an adapter like npm i @moda-grid/react, or load the core with a single CDN <script>.
- 2
Columns + data
columns with just field·header works. Add filterable·cellEditor when needed.
- 3
Rendering
Adapters need just one <DataGrid>. With the core directly, connect via 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: "Name", filterable: true },
{ field: "role", header: "Role",
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 export
</button>
<DataGrid grid={grid} columns={columns}
height={480} rowHeight={37}
selectionMode="multi-cell" columnController />
</>
);
}Every mutation recomputes a snapshot internally and notifies subscribers. Snapshots are memoized and work directly with React useSyncExternalStore.
Usage by feature — what to use
Adapters turn features on with a prop or option line; with the core alone you call the API directly.
Browse · query
| Feature | How to enable (option/prop/input) | Core API |
|---|---|---|
| Sort | On by default — click the header | toggleSort(field) / setSort(field, "asc") |
| Multi-sort | Shift + header click | toggleSort(field, true) |
| Column filter | ColumnDef.filterable: true + filterType: "text"|"number"|"date" | setFilter(field, { operator, value, valueTo? }) |
| Set filter (Excel-style) | filterType: "set" | setFilter(field, { operator: "set", values: [...] }) |
| Global search | Wire up an external input | setSearch(text) |
| Paging | GridOptions.pageSize | setPage(pageIndex, pageSize?) |
Selection · editing
| Feature | How to enable (option/prop/input) | Core API |
|---|---|---|
| Cell selection mode | selectionMode: "single-cell"|"multi-cell"|"row" | setSelectionMode(mode) |
| Range-tracked selection | selectionMode="multi-cell" + rangeTracking: "identity" | Tracks the cell range by identity after sort · filter |
| Active cell · range | Click / drag / arrows · Shift+arrows | setActiveCell(r,c) / setCellRange / navigateCell |
| Row selection + checkboxes | rowCheckboxes prop | toggleRowSelection(id) / toggleAllRows() |
| Inline editing | editable + cellEditor: "text"|"number"|"select"|"date"|"custom" | startEditing / updateEditValue / commitEditing / cancelEditing |
| Input validation | ColumnDef.validate(value, row) | On failure → snapshot.editError |
| Undo · redo | Auto-recorded (undoLimit default 100) | undo() / redo() / canUndo() |
| Copy · paste (TSV) | Adapters auto-handle ⌘/Ctrl+C·V | getSelectionTsv() / pasteTsv(tsv) |
| Selection aggregate status bar | statusBar prop (on by default) | snapshot.selectionAggregates |
| Find · replace | — | findCells / findNext / replaceAll(find, repl) |
| Cell · header context menu | contextMenu / headerContextMenu options (preset: defaultContextMenuItems) | openContextMenu / runContextMenuItem / snapshot.contextMenu |
Row status tracking (I/U/D)
| Feature | How to enable (option/prop/input) | Core API |
|---|---|---|
| Add rows | — | addRows(rows) / importCsv(csv) → marked I |
| Edit tracking | Auto-marked on edit · pasteTsv | → U state (I rows stay I when edited) |
| Delete marking · restore | — | deleteRowsByIds(ids) → D / restoreRowsByIds(ids) |
| Status column | rowStatus prop — leftmost status column | snapshot.rowStates + mg-row-I/U/D CSS classes |
| Save · cancel changes | — | validateChanges() → getChanges() → commitChanges() / clearChanges() |
Columns · rows · rendering
| Feature | How to enable (option/prop/input) | Core API |
|---|---|---|
| Column resize | resizable (default on) — drag header edge | setColumnWidth(field, px) |
| Auto width | Double-click the edge | autoSizeColumn / autoSizeAllColumns |
| Column reorder | reorderable (default on) — drag header | reorderColumn(from, to) |
| Column pinning | ColumnDef.pinned: "left"|"right" | setColumnPinned(field, pinned) |
| Show · hide columns | columnController prop (column ▾ popover) | setColumnVisible / setAllColumnsVisible |
| Multi-level group headers | ColumnDef.group + GridOptions.columnGroups | snapshot.headerGroups |
| Reset layout | — | resetColumnLayout() |
| Row drag & drop | ColumnDef.rowDrag: true | begin/update/endRowDrag · moveRow |
| Variable-height scroll anchoring | Automatic | Keeps scroll position even for rows whose height changed |
| Edit-session protection | Automatic | Ongoing edits survive sort · filter · re-render |
| Pinned rows | pinnedTopRows / pinnedBottomRows options | setPinnedTopRows / setPinnedBottomRows |
| Grand totals (tfoot) | ColumnDef.aggregationFn: "sum"|"avg"|"min"|"max"|"count" | snapshot.grandTotals |
| Cell merging | ColumnDef.merge: "row"|"col"|"both" | getCellSpan(row, col) → { rowSpan, colSpan, hidden } |
| State save & restore | — | getState() / applyState(saved) |
| Theme | --grid-* vars / .grid-theme-dark | cellClass / rowClass conditional |
Scale · hierarchy · export
| Feature | How to enable (option/prop/input) | Core API |
|---|---|---|
| Virtual scroll | Adapter: height+rowHeight props | virtualScroll + handleScroll(scrollTop) |
| Row grouping + aggregation | — | setGroupBy(["dept"]) + ColumnDef.aggregationFn |
| Pivot table | pivot prop — dimensions+measures | setPivot({ rows, columns?, values: [{field, agg}] }) / isPivot() |
| Tree data | treeData prop | treeData: { childrenKey } or { getParentId } |
| Server-side infinite scroll | serverSide prop | serverSide: { dataSource, cacheBlockSize } / refreshServerRows |
| CSV export | — | exportToCsv({ filename, visibleColumnsOnly, selectedRowsOnly }) |
| Excel · PDF export | — | exportToXlsx({ filename, styled }) / exportToPdf / print() |
Common recipes
Copy-paste-ready code snippets.
Set filter (checklist)
Filter column uniques by checklist — Excel-like UX
// Set filterType on the column
{ 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); // Select all = clear filterCSV export
Exports current state (filter·sort·expanded). UTF-8 BOM — no mojibake
grid.exportToCsv({
filename: "users.csv",
visibleColumnsOnly: true, // Exclude hidden columns (default)
selectedRowsOnly: false, // true to export only selected rows
});Save only changes (I/U/D)
Tracks add/edit/delete & sends diffs. rowStatus prop shows status column
// I = addRows/importCsv · U = edit/pasteTsv · D = deleteRowsByIds (I rows are removed instantly)
grid.addRows([{ id: "new-1", name: t.newEmp }]);
grid.deleteRowsByIds(["3", "7"]); // D marked — stays on screen until commit
grid.restoreRowsByIds(["3"]); // Unmark D
async function save() {
const errors = grid.validateChanges(); // Checks required/validate on I/U rows
if (errors.length) return console.warn(errors);
await fetch("/api/users", {
method: "POST",
body: JSON.stringify(grid.getChanges()), // { inserted, updated, deleted }
});
grid.commitChanges(); // Removes D + clears marks
}
// To just clear marks (restore the view) use grid.clearChanges()State save & restore
Sort·filter·search·paging·grouping·layout to localStorage
// Save — returns a serializable object
localStorage.setItem("grid", JSON.stringify(grid.getState()));
// Restore — missing columns are ignored, safe across schema changes
grid.applyState(JSON.parse(localStorage.getItem("grid")!));
// Partial apply works too
grid.applyState({ sortState: saved.sortState });Server-side infinite scroll
getRows auto-fires on unloaded blocks. Sort/filter → server params
const grid = new GridCore({
columns,
data: [], // Ignored in server mode
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(); // Purge cache + refetchTree data
Parent-child hierarchy as expand/collapse tree. Two data shapes
// nested — child array inside each row
new GridCore({ columns, data, treeData: { childrenKey: "children" } });
// flat — linked by parentId (rows with filtered parents promote to root)
new GridCore({ columns, data,
getRowId: (r) => r.id,
treeData: { getParentId: (r) => r.parentId },
});
grid.toggleTreeExpanded(rowId); // expand/collapseCustom cells · editors (React)
ColumnDef assigns JSX renderers & editors per column
{
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 uses #cell-{field} / #editor-{field} slots; Svelte uses cell/editor snippetsGrouping + aggregation
Group by field; aggregationFn sums/averages on group rows
{ field: "age", aggregationFn: "avg" } // Mark column for aggregation
grid.setGroupBy(["dept", "role"]); // Multi-level grouping
grid.expandAllGroups(); // Expand all
grid.collapseAllGroups(); // Collapse all
// snapshot.grandTotals also gets grand totalsCell format · custom values
Display transform & value extraction via column options
{
field: "salary",
header: t.salaryH,
valueGetter: (row) => row.pay.annual, // Extract nested value
formatter: (v) => `${Number(v).toLocaleString()}₩`, // Display transform
cellClass: (p) => (p.value > 5000 ? "text-red-500" : ""), // Conditional class
}Commercial grids charge — moda-grid is free
Set filters, grouping, aggregation, clipboard, range select, and pivot are Enterprise-only in AG Grid. moda-grid ships them all free under MIT.
Source & docs
github.com/park-taejoon/moda-grid-releases- Getting started·platform guides (React/Vue 3/Vue 2.7/Svelte/Vanilla)
- Feature guides — sort·filter·edit·virtual scroll·server-side
- GridCore headless API reference
How to use
Headless data grid — virtual scroll, pivot, tree, Excel export.