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.

Free (MIT)React · Vue 3 · Vue 2.7 · Svelte 5 · VanillaHeadless coreTypeScript

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

Loading moda-grid core from CDN…

Packages by environment

EnvironmentPackageNotes
React@moda-grid/reactDataGrid component + useGridCore hook, renderCell/renderEditor slots
Vue 3@moda-grid/vueuseGrid + DataGrid, per-column custom cell/editor slots
Vue 2.7@moda-grid/vue2Same Composition API as Vue 3
Svelte 5@moda-grid/svelterunes-based createGridStore + DataGrid
Vanilla JS / CDNmoda-grid.jsOne <script>, no build — window.ModaGrid
No framework@moda-grid/coreUse headless GridCore directly

Install via 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 # Headless core only

Use via CDN

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

Get started in 3 steps

  1. 1

    Install package

    Install an adapter like npm i @moda-grid/react, or load the core with a single CDN <script>.

  2. 2

    Columns + data

    columns with just field·header works. Add filterable·cellEditor when needed.

  3. 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

FeatureHow to enable (option/prop/input)Core API
SortOn by default — click the headertoggleSort(field) / setSort(field, "asc")
Multi-sortShift + header clicktoggleSort(field, true)
Column filterColumnDef.filterable: true + filterType: "text"|"number"|"date"setFilter(field, { operator, value, valueTo? })
Set filter (Excel-style)filterType: "set"setFilter(field, { operator: "set", values: [...] })
Global searchWire up an external inputsetSearch(text)
PagingGridOptions.pageSizesetPage(pageIndex, pageSize?)

Selection · editing

FeatureHow to enable (option/prop/input)Core API
Cell selection modeselectionMode: "single-cell"|"multi-cell"|"row"setSelectionMode(mode)
Range-tracked selectionselectionMode="multi-cell" + rangeTracking: "identity"Tracks the cell range by identity after sort · filter
Active cell · rangeClick / drag / arrows · Shift+arrowssetActiveCell(r,c) / setCellRange / navigateCell
Row selection + checkboxesrowCheckboxes proptoggleRowSelection(id) / toggleAllRows()
Inline editingeditable + cellEditor: "text"|"number"|"select"|"date"|"custom"startEditing / updateEditValue / commitEditing / cancelEditing
Input validationColumnDef.validate(value, row)On failure → snapshot.editError
Undo · redoAuto-recorded (undoLimit default 100)undo() / redo() / canUndo()
Copy · paste (TSV)Adapters auto-handle ⌘/Ctrl+C·VgetSelectionTsv() / pasteTsv(tsv)
Selection aggregate status barstatusBar prop (on by default)snapshot.selectionAggregates
Find · replace—findCells / findNext / replaceAll(find, repl)
Cell · header context menucontextMenu / headerContextMenu options (preset: defaultContextMenuItems)openContextMenu / runContextMenuItem / snapshot.contextMenu

Row status tracking (I/U/D)

FeatureHow to enable (option/prop/input)Core API
Add rows—addRows(rows) / importCsv(csv) → marked I
Edit trackingAuto-marked on edit · pasteTsv→ U state (I rows stay I when edited)
Delete marking · restore—deleteRowsByIds(ids) → D / restoreRowsByIds(ids)
Status columnrowStatus prop — leftmost status columnsnapshot.rowStates + mg-row-I/U/D CSS classes
Save · cancel changes—validateChanges() → getChanges() → commitChanges() / clearChanges()

Columns · rows · rendering

FeatureHow to enable (option/prop/input)Core API
Column resizeresizable (default on) — drag header edgesetColumnWidth(field, px)
Auto widthDouble-click the edgeautoSizeColumn / autoSizeAllColumns
Column reorderreorderable (default on) — drag headerreorderColumn(from, to)
Column pinningColumnDef.pinned: "left"|"right"setColumnPinned(field, pinned)
Show · hide columnscolumnController prop (column ▾ popover)setColumnVisible / setAllColumnsVisible
Multi-level group headersColumnDef.group + GridOptions.columnGroupssnapshot.headerGroups
Reset layout—resetColumnLayout()
Row drag & dropColumnDef.rowDrag: truebegin/update/endRowDrag · moveRow
Variable-height scroll anchoringAutomaticKeeps scroll position even for rows whose height changed
Edit-session protectionAutomaticOngoing edits survive sort · filter · re-render
Pinned rowspinnedTopRows / pinnedBottomRows optionssetPinnedTopRows / setPinnedBottomRows
Grand totals (tfoot)ColumnDef.aggregationFn: "sum"|"avg"|"min"|"max"|"count"snapshot.grandTotals
Cell mergingColumnDef.merge: "row"|"col"|"both"getCellSpan(row, col) → { rowSpan, colSpan, hidden }
State save & restore—getState() / applyState(saved)
Theme--grid-* vars / .grid-theme-darkcellClass / rowClass conditional

Scale · hierarchy · export

FeatureHow to enable (option/prop/input)Core API
Virtual scrollAdapter: height+rowHeight propsvirtualScroll + handleScroll(scrollTop)
Row grouping + aggregation—setGroupBy(["dept"]) + ColumnDef.aggregationFn
Pivot tablepivot prop — dimensions+measuressetPivot({ rows, columns?, values: [{field, agg}] }) / isPivot()
Tree datatreeData proptreeData: { childrenKey } or { getParentId }
Server-side infinite scrollserverSide propserverSide: { 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 filter

CSV 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 + refetch

Tree 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/collapse

Custom 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 snippets

Grouping + 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 totals

Cell 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.

data grid

Related tools