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.
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
Paquetes por entorno
| Entorno | Paquete | Notas |
|---|---|---|
| React | @moda-grid/react | DataGrid + hook useGridCore, slots renderCell/renderEditor |
| Vue 3 | @moda-grid/vue | useGrid + DataGrid, slots de celda/editor por columna |
| Vue 2.7 | @moda-grid/vue2 | Mismo Composition API que Vue 3 |
| Svelte 5 | @moda-grid/svelte | createGridStore runes + DataGrid |
| JS puro / CDN | moda-grid.js | Un <script>, sin build — window.ModaGrid |
| Sin framework | @moda-grid/core | Usa GridCore headless directo |
Instalar con 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 # Solo núcleo headlessUsar con CDN
https://grid.modaolive.com/moda-grid.jshttps://grid.modaolive.com/style.cssEmpieza en 3 pasos
- 1
Instalar paquete
Instala un adaptador como npm i @moda-grid/react, o carga el núcleo con un solo <script> de CDN.
- 2
Columnas + datos
columns con solo field·header funciona. Añade filterable·cellEditor cuando lo necesites.
- 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ón | Cómo activar (opción/prop/entrada) | API núcleo |
|---|---|---|
| Ordenar | Activo por defecto — clic en el encabezado | toggleSort(field) / setSort(field, "asc") |
| Multi-orden | Shift + clic en el encabezado | toggleSort(field, true) |
| Filtro de columna | ColumnDef.filterable: true + filterType: "text"|"number"|"date" | setFilter(field, { operator, value, valueTo? }) |
| Filtro Set (estilo Excel) | filterType: "set" | setFilter(field, { operator: "set", values: [...] }) |
| Búsqueda global | Conecta un input externo | setSearch(text) |
| Paginación | GridOptions.pageSize | setPage(pageIndex, pageSize?) |
Selección · edición
| Función | Cómo activar (opción/prop/entrada) | API núcleo |
|---|---|---|
| Modo de selección de celda | selectionMode: "single-cell"|"multi-cell"|"row" | setSelectionMode(mode) |
| Selección de rango rastreada | selectionMode="multi-cell" + rangeTracking: "identity" | Rastrea el rango de celdas por identidad tras ordenar · filtrar |
| Celda activa · rango | Clic / arrastrar / flechas · Shift+flechas | setActiveCell(r,c) / setCellRange / navigateCell |
| Selección de fila + casillas | rowCheckboxes prop | toggleRowSelection(id) / toggleAllRows() |
| Edición en línea | editable + cellEditor: "text"|"number"|"select"|"date"|"custom" | startEditing / updateEditValue / commitEditing / cancelEditing |
| Validación de entrada | ColumnDef.validate(value, row) | En caso de fallo → snapshot.editError |
| Deshacer · rehacer | Grabación automática (undoLimit 100 por defecto) | undo() / redo() / canUndo() |
| Copiar · pegar (TSV) | El adaptador maneja ⌘/Ctrl+C·V | getSelectionTsv() / pasteTsv(tsv) |
| Barra de agregados de selección | prop statusBar (activo por defecto) | snapshot.selectionAggregates |
| Buscar · reemplazar | — | findCells / findNext / replaceAll(find, repl) |
| Menú contextual de celda · encabezado | opciones contextMenu / headerContextMenu (preset: defaultContextMenuItems) | openContextMenu / runContextMenuItem / snapshot.contextMenu |
Seguimiento de estado de fila (I/U/D)
| Función | Cómo activar (opción/prop/entrada) | API núcleo |
|---|---|---|
| Añadir filas | — | addRows(rows) / importCsv(csv) → marca I |
| Seguimiento de edición | Se marca al editar · pasteTsv | → estado U (las filas I siguen I al editar) |
| Marca de borrado · restaurar | — | deleteRowsByIds(ids) → D / restoreRowsByIds(ids) |
| Columna de estado | prop rowStatus — columna de estado a la izquierda | snapshot.rowStates + clases CSS mg-row-I/U/D |
| Guardar · cancelar cambios | — | validateChanges() → getChanges() → commitChanges() / clearChanges() |
Columnas · filas · renderizado
| Función | Cómo activar (opción/prop/entrada) | API núcleo |
|---|---|---|
| Redimensionar columnas | resizable (activo) — arrastra el borde del encabezado | setColumnWidth(field, px) |
| Ancho automático | Doble clic en el borde | autoSizeColumn / autoSizeAllColumns |
| Reordenar columnas | reorderable (activo) — arrastra el encabezado | reorderColumn(from, to) |
| Fijar columnas | ColumnDef.pinned: "left"|"right" | setColumnPinned(field, pinned) |
| Mostrar · ocultar columnas | prop columnController (popover de columnas ▾) | setColumnVisible / setAllColumnsVisible |
| Encabezados de grupo multinivel | ColumnDef.group + GridOptions.columnGroups | snapshot.headerGroups |
| Reiniciar diseño | — | resetColumnLayout() |
| Arrastrar y soltar filas | ColumnDef.rowDrag: true | begin/update/endRowDrag · moveRow |
| Anclaje de scroll de altura variable | Automático | Mantiene la posición de scroll en filas con altura cambiada |
| Protección de sesión de edición | Automático | La edición en curso sobrevive a ordenar · filtrar · render |
| Filas fijadas | opciones pinnedTopRows / pinnedBottomRows | setPinnedTopRows / setPinnedBottomRows |
| Totales generales (tfoot) | ColumnDef.aggregationFn: "sum"|"avg"|"min"|"max"|"count" | snapshot.grandTotals |
| Fusión de celdas | ColumnDef.merge: "row"|"col"|"both" | getCellSpan(row, col) → { rowSpan, colSpan, hidden } |
| Guardar y restaurar estado | — | getState() / applyState(saved) |
| Tema | vars --grid-* / .grid-theme-dark | cellClass / rowClass condicionales |
Escala · jerarquía · exportar
| Función | Cómo activar (opción/prop/entrada) | API núcleo |
|---|---|---|
| Scroll virtual | Adapter: height+rowHeight | virtualScroll + handleScroll(scrollTop) |
| Agrupación + agregado | — | setGroupBy(["dept"]) + ColumnDef.aggregationFn |
| Tabla pivote | prop pivot — dimensiones+medidas | setPivot({ rows, columns?, values: [{field, agg}] }) / isPivot() |
| Datos árbol | treeData prop | treeData: { childrenKey } o { getParentId } |
| Scroll infinito servidor | serverSide prop | serverSide: { 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 filtroExportar 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é + repiteDatos á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/contraerCeldas · 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/editorAgrupar + 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 totalesFormato 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.