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.

Gratis (MIT)React · Vue 3 · Vue 2.7 · Svelte 5 · Vanilla35 tipos de gráficoRenderizado SVG · ~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.

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

Paquetes por entorno

EntornoPaqueteNotas
React@moda-chart/reactComponente ChartView + hook useChartCore (useSyncExternalStore)
Vue 3@moda-chart/vueuseChart + ChartView, reactividad shallowRef
Vue 2.7@moda-chart/vue2Mismo Composition API que Vue 3
Svelte 5@moda-chart/svelteBinding readable store + ChartView
JS puro / CDNmoda-chart.jsUn <script>, sin build — window.ModaChart
Sin framework@moda-chart/coreUsa ChartCore headless + mountChart directo

Instalar con npm

npm i @moda-chart/react # React
npm i @moda-chart/vue # Vue 3
npm i @moda-chart/vue2 # Vue 2.7
npm i @moda-chart/svelte # Svelte 5
npm i @moda-chart/core # Solo núcleo headless

Usar con CDN

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

Empieza en 3 pasos

  1. 1

    Instalar paquete

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

  2. 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. 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.setType

Uso por función

Tipos de gráfico (35)

FunciónCómo activarAPI
Cartesianostype: "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 mixtasseries[].type por seriecombo línea + barra
Horizontaldirection: "horizontal" (tipos barra)eje de valores pasa al eje x

Datos

FunciónCómo activarAPI
Eje de categoríascategories: 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 puntoseries[].itemStyle: (ctx) => ({color?, name?})equiv. a itemStyler de AG Charts
Barras de error · tendenciasseries[].errors / series[].trendtrend: { type: "linear"|"movingAverage" }
Categorías agrupadascategories: [[grupo, hoja], …] tuplasrenderiza una segunda fila de ticks

Interacciones

FunciónCómo activarAPI
Leyendalegend: true | { position }clic alterna + hover dimming / toggleLegend / hoverLegend
Checkboxes de leyendalegend: { checkboxes: true }evento legendCheck { id, checked }
Tooltiptooltip: "point"|"shared"|{ mode, format, render }shared incluye crosshair; render para HTML propio
Zoom · panzoom: true | { wheel, pan, axes, select }setZoomWindow / resetZoom — selección de eje x/y/xy
Selección brushbrush: true — arrastra para seleccionar rangoevento selectionChange / setSelection
Navegador · scrollbarnavigator: true | scrollbar: truecontrola la ventana con minimapa o tira de zoom
Drill-downdrilldown: { "etiqueta": subnivel }drillDown/drillUp/drillUpAll + botón ‹Back
Selección de puntoallowPointSelect: trueselectPoint / clearSelected, .mc-selected
Menú contextualcontextMenu: true | { items }reset de zoom/SVG·PNG integrados + ítems propios menuAction
Sync de gráficossync: "claveGrupo"gráficos con la misma clave comparten hover·zoom
Zoom con pellizcoautomático (con zoom activo)zoom anclado según separación de dedos
Sincronía de tema del SOautomáticosigue prefers-color-scheme — sincroniza variables al cambiar a oscuro

Anotaciones · export · accesibilidad

FunciónCómo activarAPI
Dibujar anotacionesdrawing: true + chart.setDrawMode(tool)line/hline/vline/rect/channel/fibonacci/measure + getDrawings
Guardar SVG·PNGintegrado en contextMenu o llamada directadownloadSVG / downloadPNG export
Sparkline—mountSparkline — mini gráfico sin ejes
Guardar/restaurar estado—getState / setState — ida y vuelta de zoom·ocultos·anotaciones
Navegación por tecladoautomático — mueve el foco del puntoincluye atributos a11y como aria-pressed
Temavars CSS --chart-* + ciclo de paletapersonaliza vía contrato DOM de clases .mc-*
Eventos de impresiónautomáticoeventos 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 nivel

Anotaciones

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 derecha

Có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-releases

Cómo usar

Charts headless — drill-down, sync, velas, mapa.

chart library

Herramientas relacionadas