ModaChart — Gráficos
Charts headless — drill-down, sync, velas, mapa.
Librería de gráficos headless que dibuja 35 tipos igual en React, Vue, Svelte y JS puro.
Toda la lógica — escalas, interacción, eventos — vive en un núcleo TypeScript puro; cada adaptador solo es un binding reactivo fino. Todos los renderizadores emiten el mismo contrato DOM, así que el resultado es idéntico.
Incluye funciones de pago como zoom, navegador, drilldown, anotaciones y sincronización — más mapa mundi integrado y sparklines — en ~250KB.
Demo en vivo
Funciona con el núcleo real cargado por CDN. Cambia entre todos los tipos — línea, barra, circular, velas, sankey, sunburst, mapa mundial — y prueba leyenda, tooltip, zoom, brush, navigator, selección de puntos, menú contextual, drilldown y anotaciones (tendencia/Fibonacci/rango). El panel inferior muestra el código que reproduce tu configuración en tiempo real.
Paquetes por entorno
| Entorno | Paquete | Notas |
|---|---|---|
| React | @moda-chart/react | Componente ChartView + hook useChartCore (useSyncExternalStore) |
| Vue 3 | @moda-chart/vue | useChart + ChartView, reactividad shallowRef |
| Vue 2.7 | @moda-chart/vue2 | Mismo Composition API que Vue 3 |
| Svelte 5 | @moda-chart/svelte | Binding readable store + ChartView |
| JS puro / CDN | moda-chart.js | Un <script>, sin build — window.ModaChart |
| Sin framework | @moda-chart/core | Usa ChartCore headless + mountChart directo |
Instalar con npm
npm i @moda-chart/react # Reactnpm i @moda-chart/vue # Vue 3npm i @moda-chart/vue2 # Vue 2.7npm i @moda-chart/svelte # Svelte 5npm i @moda-chart/core # Solo núcleo headlessUsar con CDN
https://chart.modaolive.com/moda-chart.jshttps://chart.modaolive.com/style.cssEmpieza en 3 pasos
- 1
Instalar paquete
Instala un adaptador como npm i @moda-chart/react, o carga el núcleo con un <script> de CDN.
- 2
Tipo + datos
Solo pasa type con series·categories. Los campos de datos por tipo como points·ohlc·tree·links se añaden cuando haga falta.
- 3
Render y control
Los adaptadores solo necesitan un <ChartView>. mountChart(el, options) de vanilla conecta el DOM y todas las interacciones.
// npm i @moda-chart/react
import { ChartView, useChartCore } from "@moda-chart/react";
import "@moda-chart/react/styles.css";
function App() {
const { chart, snapshot } = useChartCore({
type: "line",
series: [
{ name: "Ventas", values: [12, 24, 16, 30] },
{ name: "Costo", values: [8, 14, 12, 20] },
],
categories: ["Ene", "Feb", "Mar", "Abr"],
legend: { position: "top" },
tooltip: { mode: "shared" },
zoom: true,
});
return <ChartView chart={chart} />;
}
// cambios posteriores con métodos del core: chart.setData / chart.setTypeUso por función
Tipos de gráfico (35)
| Función | Cómo activar | API |
|---|---|---|
| Cartesianos | type: "line"|"step"|"spline"|"area"|"bar"|"stacked-bar"|"percent-stacked-bar"|"waterfall"|"histogram"|"range-bar"|"range-area"|"population-pyramid" | chart.setType(type) cambio en runtime |
| Circulares · polares | "pie"|"donut"|"nightingale"|"radial-bar"|"radial-column"|"radar"|"radar-area" | categories = ángulo, values = radio |
| Distribución · finanzas | "scatter"|"bubble"|"heatmap"|"candlestick"|"ohlc"|"boxplot" | points {x,y,z} / ohlc / box / matriz de series |
| Flujo · jerarquía | "funnel"|"cone-funnel"|"pyramid"|"sankey"|"chord"|"sunburst"|"treemap"|"organization"|"wordcloud" | series.tree / links / chord.matrix |
| Gauge · mapa | "gauge"|"linear-gauge"|"pictogram"|"map" | gauge:{min,max,target} / map:{topology} + WORLD_TOPOLOGY integrado |
| Series mixtas | series[].type por serie | combo línea + barra |
| Horizontal | direction: "horizontal" (tipos barra) | eje de valores pasa al eje x |
Datos
| Función | Cómo activar | API |
|---|---|---|
| Eje de categorías | categories: string[] / number[] / Date[] | string=band, number=linear, Date=time auto |
| Reemplazar datos | — | chart.setData(series, categories) |
| Actualizar punto | — | chart.updatePoint(...) — actualización en tiempo real (gauges) |
| Estilo por punto | series[].itemStyle: (ctx) => ({color?, name?}) | equiv. a itemStyler de AG Charts |
| Barras de error · tendencias | series[].errors / series[].trend | trend: { type: "linear"|"movingAverage" } |
| Categorías agrupadas | categories: [[grupo, hoja], …] tuplas | renderiza una segunda fila de ticks |
Interacciones
| Función | Cómo activar | API |
|---|---|---|
| Leyenda | legend: true | { position } | clic alterna + hover dimming / toggleLegend / hoverLegend |
| Checkboxes de leyenda | legend: { checkboxes: true } | evento legendCheck { id, checked } |
| Tooltip | tooltip: "point"|"shared"|{ mode, format, render } | shared incluye crosshair; render para HTML propio |
| Zoom · pan | zoom: true | { wheel, pan, axes, select } | setZoomWindow / resetZoom — selección de eje x/y/xy |
| Selección brush | brush: true — arrastra para seleccionar rango | evento selectionChange / setSelection |
| Navegador · scrollbar | navigator: true | scrollbar: true | controla la ventana con minimapa o tira de zoom |
| Drill-down | drilldown: { "etiqueta": subnivel } | drillDown/drillUp/drillUpAll + botón ‹Back |
| Selección de punto | allowPointSelect: true | selectPoint / clearSelected, .mc-selected |
| Menú contextual | contextMenu: true | { items } | reset de zoom/SVG·PNG integrados + ítems propios menuAction |
| Sync de gráficos | sync: "claveGrupo" | gráficos con la misma clave comparten hover·zoom |
| Zoom con pellizco | automático (con zoom activo) | zoom anclado según separación de dedos |
| Sincronía de tema del SO | automático | sigue prefers-color-scheme — sincroniza variables al cambiar a oscuro |
Anotaciones · export · accesibilidad
| Función | Cómo activar | API |
|---|---|---|
| Dibujar anotaciones | drawing: true + chart.setDrawMode(tool) | line/hline/vline/rect/channel/fibonacci/measure + getDrawings |
| Guardar SVG·PNG | integrado en contextMenu o llamada directa | downloadSVG / downloadPNG export |
| Sparkline | — | mountSparkline — mini gráfico sin ejes |
| Guardar/restaurar estado | — | getState / setState — ida y vuelta de zoom·ocultos·anotaciones |
| Navegación por teclado | automático — mueve el foco del punto | incluye atributos a11y como aria-pressed |
| Tema | vars CSS --chart-* + ciclo de paleta | personaliza vía contrato DOM de clases .mc-* |
| Eventos de impresión | automático | eventos beforePrint / afterPrint |
Recetas por caso
Drill-down
Clic en un punto para bajar a datos hijos — ‹Back automático
new ChartCore({
type: "bar",
series: [{ name: "Mensual", values: [12, 24, 16] }],
categories: ["Ene", "Feb", "Mar"],
drilldown: {
"Ene": {
series: [{ name: "Ene semanal", values: [3, 4, 2, 3] }],
categories: ["Sem 1", "Sem 2", "Sem 3", "Sem 4"],
title: "Ventas ene semanales",
},
},
});
chart.drillUp(); // subir un nivelAnotaciones
Tendencias·Fibonacci·medición de zonas — nivel premium de AG Charts
chart.setDrawMode("fibonacci"); // arrastra → niveles de retroceso 0~100%
chart.setDrawMode("channel"); // canal paralelo + banda sombreada
chart.setDrawMode("measure"); // etiquetas Δx/Δy automáticas
chart.getDrawings(); // DrawingInput[] (coords. de datos)
chart.clearDrawings();
chart.setDrawMode(null); // desactivar (Esc también)Datos en tiempo real
setData es idempotente — llamadas misma-ref ignoradas
setInterval(() => {
series[0].values.push(rand()); series[0].values.shift();
chart.setData(series, categories); // re-renderiza si la referencia es un array nuevo
}, 1000);
// para cambiar un solo punto, como un gauge
chart.updatePoint(seriesId, 0, nextValue);Sync de gráficos
Gráficos del mismo grupo comparten hover·zoom — para dashboards
mountChart(elA, { type: "line", series, categories, sync: "dash" });
mountChart(elB, { type: "bar", series, categories, sync: "dash" });
// zoom/hover en uno se propaga al otro con el mismo dominio
// (los cambios propagados no se re-propagan — sin bucle)Velas (acciones)
Velas desde ohlc — colores vía --chart-up/down-color
new ChartCore({
type: "candlestick",
categories: ["10/1", "10/2", "10/3"],
series: [{
name: "Precio",
ohlc: [
[100, 108, 97, 105], // [open, high, low, close]
[105, 110, 101, 103],
[103, 112, 102, 111],
],
}],
});Mapa mundial (choropleth)
Natural Earth 110m integrado — join por código, sin ejes
import { WORLD_TOPOLOGY } from "@moda-chart/core"; // en CDN: window.ModaChart.WORLD_TOPOLOGY
new ChartCore({
type: "map",
series: [{
name: "Usuarios por país",
mapData: { KOR: 92, JPN: 64, USA: 88, DEU: 40 },
}],
map: { topology: WORLD_TOPOLOGY, projection: "mercator" },
});
// regiones sin join usan .mc-map-no-data; leyenda en degradado abajo a la derechaCódigo y docs
Las guías (tabla de tipos, interacciones, variables de tema, mapeo de migración) se mantienen en el repo público.
park-taejoon/moda-chart-releasesCómo usar
Charts headless — drill-down, sync, velas, mapa.