ModaGrid — Grid

Grid headless — scroll virtual, pivote, árbol, Excel.

Librería de data-grid headless con comportamiento idéntico en React, Vue, Svelte y JS puro.

Toda la lógica de datos — ordenación, filtros, búsqueda, paginación, edición — vive en un núcleo TypeScript puro (GridCore); cada adaptador es una capa de renderizado fina. El comportamiento es idéntico en todos los frameworks.

Funciones que son de pago (Enterprise) en otras grids — filtros Set, agrupación+agregados, portapapeles, selección por rango — gratis bajo MIT.

Gratis (MIT)React · Vue 3 · Vue 2.7 · Svelte 5 · VanillaNúcleo headlessTypeScript

Demo en vivo

Funciona con el núcleo real cargado por CDN. Prueba ordenación, multi-orden, filtros por operador/Set, búsqueda, paginación, scroll virtual, selección de celda/rango/fila, edición en línea, Undo/Redo, portapapeles, redimensión/reorden/fijar/ocultar columnas, agrupación y agregados, filas fijadas, totales, guardar/restaurar estado, arrastre de filas, seguimiento I/U/D y guardado de cambios; también datos en árbol y scroll infinito de servidor. El panel bajo la rejilla muestra en tiempo real el código que reproduce tu configuración y llamadas API.

Edita con doble clic o escribiendo · arrastra para rango · ⌘/Ctrl+C·V copiar/pegar · ⌘/Ctrl+Z·Y deshacer/rehacer · flechas/Shift+flechas mueven y amplían · ⠿ arrastra filas · borde del encabezado ajusta ancho · arrastra encabezado para reordenar

Cargando el núcleo de moda-grid desde CDN…

Paquetes por entorno

EntornoPaqueteNotas
React@moda-grid/reactDataGrid + hook useGridCore, slots renderCell/renderEditor
Vue 3@moda-grid/vueuseGrid + DataGrid, slots de celda/editor por columna
Vue 2.7@moda-grid/vue2Mismo Composition API que Vue 3
Svelte 5@moda-grid/sveltecreateGridStore runes + DataGrid
JS puro / CDNmoda-grid.jsUn <script>, sin build — window.ModaGrid
Sin framework@moda-grid/coreUsa GridCore headless directo

Instalar con 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 # Solo núcleo headless

Usar con CDN

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

Empieza en 3 pasos

  1. 1

    Instalar paquete

    Instala un adaptador como npm i @moda-grid/react, o carga el núcleo con un solo <script> de CDN.

  2. 2

    Columnas + datos

    columns con solo field·header funciona. Añade filterable·cellEditor cuando lo necesites.

  3. 3

    Render

    Los adaptadores solo necesitan un <DataGrid>. Con el núcleo directo, conecta con 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: "Nombre", filterable: true },
  { field: "role", header: "Rol",
    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" })}>
        Exportar CSV
      </button>
      <DataGrid grid={grid} columns={columns}
        height={480} rowHeight={37}
        selectionMode="multi-cell" columnController />
    </>
  );
}

Cada mutación recalcula un snapshot interno y notifica a los suscriptores. Los snapshots están memoizados y funcionan con React useSyncExternalStore.

Uso por función — qué usar

Los adaptadores activan casi todo con un prop u opción; con solo el núcleo llamas a la API directamente.

Consulta · navegación

FunciónCómo activar (opción/prop/entrada)API núcleo
OrdenarActivo por defecto — clic en el encabezadotoggleSort(field) / setSort(field, "asc")
Multi-ordenShift + clic en el encabezadotoggleSort(field, true)
Filtro de columnaColumnDef.filterable: true + filterType: "text"|"number"|"date"setFilter(field, { operator, value, valueTo? })
Filtro Set (estilo Excel)filterType: "set"setFilter(field, { operator: "set", values: [...] })
Búsqueda globalConecta un input externosetSearch(text)
PaginaciónGridOptions.pageSizesetPage(pageIndex, pageSize?)

Selección · edición

FunciónCómo activar (opción/prop/entrada)API núcleo
Modo de selección de celdaselectionMode: "single-cell"|"multi-cell"|"row"setSelectionMode(mode)
Selección de rango rastreadaselectionMode="multi-cell" + rangeTracking: "identity"Rastrea el rango de celdas por identidad tras ordenar · filtrar
Celda activa · rangoClic / arrastrar / flechas · Shift+flechassetActiveCell(r,c) / setCellRange / navigateCell
Selección de fila + casillasrowCheckboxes proptoggleRowSelection(id) / toggleAllRows()
Edición en líneaeditable + cellEditor: "text"|"number"|"select"|"date"|"custom"startEditing / updateEditValue / commitEditing / cancelEditing
Validación de entradaColumnDef.validate(value, row)En caso de fallo → snapshot.editError
Deshacer · rehacerGrabación automática (undoLimit 100 por defecto)undo() / redo() / canUndo()
Copiar · pegar (TSV)El adaptador maneja ⌘/Ctrl+C·VgetSelectionTsv() / pasteTsv(tsv)
Barra de agregados de selecciónprop statusBar (activo por defecto)snapshot.selectionAggregates
Buscar · reemplazar—findCells / findNext / replaceAll(find, repl)
Menú contextual de celda · encabezadoopciones contextMenu / headerContextMenu (preset: defaultContextMenuItems)openContextMenu / runContextMenuItem / snapshot.contextMenu

Seguimiento de estado de fila (I/U/D)

FunciónCómo activar (opción/prop/entrada)API núcleo
Añadir filas—addRows(rows) / importCsv(csv) → marca I
Seguimiento de ediciónSe marca al editar · pasteTsv→ estado U (las filas I siguen I al editar)
Marca de borrado · restaurar—deleteRowsByIds(ids) → D / restoreRowsByIds(ids)
Columna de estadoprop rowStatus — columna de estado a la izquierdasnapshot.rowStates + clases CSS mg-row-I/U/D
Guardar · cancelar cambios—validateChanges() → getChanges() → commitChanges() / clearChanges()

Columnas · filas · renderizado

FunciónCómo activar (opción/prop/entrada)API núcleo
Redimensionar columnasresizable (activo) — arrastra el borde del encabezadosetColumnWidth(field, px)
Ancho automáticoDoble clic en el bordeautoSizeColumn / autoSizeAllColumns
Reordenar columnasreorderable (activo) — arrastra el encabezadoreorderColumn(from, to)
Fijar columnasColumnDef.pinned: "left"|"right"setColumnPinned(field, pinned)
Mostrar · ocultar columnasprop columnController (popover de columnas ▾)setColumnVisible / setAllColumnsVisible
Encabezados de grupo multinivelColumnDef.group + GridOptions.columnGroupssnapshot.headerGroups
Reiniciar diseño—resetColumnLayout()
Arrastrar y soltar filasColumnDef.rowDrag: truebegin/update/endRowDrag · moveRow
Anclaje de scroll de altura variableAutomáticoMantiene la posición de scroll en filas con altura cambiada
Protección de sesión de ediciónAutomáticoLa edición en curso sobrevive a ordenar · filtrar · render
Filas fijadasopciones pinnedTopRows / pinnedBottomRowssetPinnedTopRows / setPinnedBottomRows
Totales generales (tfoot)ColumnDef.aggregationFn: "sum"|"avg"|"min"|"max"|"count"snapshot.grandTotals
Fusión de celdasColumnDef.merge: "row"|"col"|"both"getCellSpan(row, col) → { rowSpan, colSpan, hidden }
Guardar y restaurar estado—getState() / applyState(saved)
Temavars --grid-* / .grid-theme-darkcellClass / rowClass condicionales

Escala · jerarquía · exportar

FunciónCómo activar (opción/prop/entrada)API núcleo
Scroll virtualAdapter: height+rowHeightvirtualScroll + handleScroll(scrollTop)
Agrupación + agregado—setGroupBy(["dept"]) + ColumnDef.aggregationFn
Tabla pivoteprop pivot — dimensiones+medidassetPivot({ rows, columns?, values: [{field, agg}] }) / isPivot()
Datos árboltreeData proptreeData: { childrenKey } o { getParentId }
Scroll infinito servidorserverSide propserverSide: { dataSource, cacheBlockSize } / refreshServerRows
Exportar CSV—exportToCsv({ filename, visibleColumnsOnly, selectedRowsOnly })
Excel · PDF export—exportToXlsx({ filename, styled }) / exportToPdf / print()

Recetas frecuentes

Fragmentos de código listos para copiar.

Filtro Set (checklist)

Filtra únicos por checklist — mismo UX que Excel

// Define filterType en la columna
{ 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);   // Seleccionar todo = quitar filtro

Exportar CSV

Exporta el estado actual (filtro·orden·expansión). BOM UTF-8 sin mojibake

grid.exportToCsv({
  filename: "users.csv",
  visibleColumnsOnly: true,   // Excluye columnas ocultas (por defecto)
  selectedRowsOnly: false,    // true para exportar solo filas elegidas
});

Guardar solo cambios (I/U/D)

Marca alta/edición/baja, envía diffs. rowStatus muestra estado

// I = addRows/importCsv · U = editar/pasteTsv · D = deleteRowsByIds (las filas I se quitan al momento)
grid.addRows([{ id: "new-1", name: t.newEmp }]);
grid.deleteRowsByIds(["3", "7"]);   // Marcada D — visible hasta el commit
grid.restoreRowsByIds(["3"]);       // Quitar marca D

async function save() {
  const errors = grid.validateChanges();          // Valida required/validate en filas I/U
  if (errors.length) return console.warn(errors);
  await fetch("/api/users", {
    method: "POST",
    body: JSON.stringify(grid.getChanges()),      // { inserted, updated, deleted }
  });
  grid.commitChanges();                           // Borra D + limpia marcas
}
// Para solo limpiar marcas (restaurar la vista) usa grid.clearChanges()

Guardar y restaurar estado

Orden·filtro·búsqueda·paginación·agrupación·layout a localStorage

// Guardar — devuelve un objeto serializable
localStorage.setItem("grid", JSON.stringify(grid.getState()));

// Restaurar — ignora columnas inexistentes, seguro ante cambios de esquema
grid.applyState(JSON.parse(localStorage.getItem("grid")!));

// También aplicación parcial
grid.applyState({ sortState: saved.sortState });

Scroll infinito servidor

getRows se dispara en bloques sin cargar. Orden/filtro → params

const grid = new GridCore({
  columns,
  data: [],                       // Ignorado en modo servidor
  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();          // Limpia caché + repite

Datos árbol

Jerarquía padre-hijo como árbol. Dos formas de datos

// nested — array de hijos dentro de la fila
new GridCore({ columns, data, treeData: { childrenKey: "children" } });

// flat — enlazado por parentId (filas con padre filtrado suben a raíz)
new GridCore({ columns, data,
  getRowId: (r) => r.id,
  treeData: { getParentId: (r) => r.parentId },
});

grid.toggleTreeExpanded(rowId);    // expandir/contraer

Celdas · editores custom (React)

ColumnDef asigna renderers JSX y editores por columna

{
  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 usa slots #cell-{field} / #editor-{field}; Svelte usa snippets cell/editor

Agrupar + agregar

Agrupa por campo; aggregationFn muestra suma/promedio

{ field: "age", aggregationFn: "avg" }     // Marca columna para agregado

grid.setGroupBy(["dept", "role"]);   // Agrupación multinivel
grid.expandAllGroups();              // Expandir todo
grid.collapseAllGroups();            // Contraer todo
// snapshot.grandTotals también calcula totales

Formato de celda · valores custom

Transformación display y extracción via opciones

{
  field: "salary",
  header: t.salaryH,
  valueGetter: (row) => row.pay.annual,                  // Extrae valor anidado
  formatter: (v) => `${Number(v).toLocaleString()}₩`,  // Transforma display
  cellClass: (p) => (p.value > 5000 ? "text-red-500" : ""), // Clase condicional
}

Las grids comerciales cobran — moda-grid es gratis

Filtros Set, agrupación, agregados, portapapeles, selección por rango y pivot son de pago (Enterprise) en AG Grid. moda-grid los incluye gratis bajo MIT.

Código y docs

github.com/park-taejoon/moda-grid-releases
  • Inicio·guías por plataforma (React/Vue 3/Vue 2.7/Svelte/Vanilla)
  • Guías por función — orden·filtro·edición·scroll virtual·servidor
  • Referencia API GridCore headless

Cómo usar

Grid headless — scroll virtual, pivote, árbol, Excel.

data grid

Herramientas relacionadas