ModaChart — 图表库

无头图表 — 下钻·同步·K线·地图。

在 React·Vue·Svelte·原生 JS 中相同呈现 35 种图表的无头图表库。

刻度计算、交互、事件等全部逻辑放在纯 TypeScript 核心,各框架适配器只做轻量响应式绑定。所有渲染器生成相同的 DOM 契约,结果始终一致。

包含商业图表的付费级功能(缩放、导航器、下钻、注释绘制、图表同步),还内置世界地图和迷你图——打包约 250KB,很轻。

免费 (MIT)React · Vue 3 · Vue 2.7 · Svelte 5 · Vanilla35 种图表类型SVG 渲染 · ~250KB

实时演示

使用从 CDN 加载的真实核心运行。可在折线·柱状·饼图到 K线·桑基·旭日·世界地图之间切换,并可试用图例·提示·缩放·刷选·导航器·点选·右键菜单·下钻·注释绘制(趋势线/斐波那契/区间测量)。下方面板实时显示复现当前设置的代码。

正在从 CDN 加载 moda-chart 核心…

各环境包

使用环境包备注
React@moda-chart/reactChartView组件 + useChartCore钩 (useSyncExternalStore)
Vue 3@moda-chart/vueuseChart + ChartView, shallowRef响应式
Vue 2.7@moda-chart/vue2与Vue 3相同Composition API
Svelte 5@moda-chart/sveltereadable store联动 + ChartView
纯JS / CDNmoda-chart.js无需构建,一行<script>,window.ModaChart
无框架@moda-chart/core直接使用无头ChartCore + mountChart

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 # 仅无头核心

CDN 直接使用

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

三步开始

  1. 1

    安装包

    安装 npm i @moda-chart/react 等适配器,或用一行 CDN <script> 加载核心。

  2. 2

    类型 + 数据

    只需传 type 和 series·categories。points·ohlc·tree·links 等按类型的数据字段在需要时添加。

  3. 3

    渲染·操作

    适配器只需一个 <ChartView>。vanilla 的 mountChart(el, options) 会接管 DOM 与全部交互。

// 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: "销售", values: [12, 24, 16, 30] },
      { name: "费用", values: [8, 14, 12, 20] },
    ],
    categories: ["1月", "2月", "3月", "4月"],
    legend: { position: "top" },
    tooltip: { mode: "shared" },
    zoom: true,
  });
  return <ChartView chart={chart} />;
}
// 后续修改用 chart.setData / chart.setType 等核心方法

按功能使用

图表类型(35种)

功能开启方式API
直角坐标图type: "line"|"step"|"spline"|"area"|"bar"|"stacked-bar"|"percent-stacked-bar"|"waterfall"|"histogram"|"range-bar"|"range-area"|"population-pyramid"chart.setType(type) 运行时切换
圆形·极坐标"pie"|"donut"|"nightingale"|"radial-bar"|"radial-column"|"radar"|"radar-area"categories = 角度, values = 半径
分布·财务"scatter"|"bubble"|"heatmap"|"candlestick"|"ohlc"|"boxplot"points {x,y,z} / ohlc / box / 系列矩阵
流向·层级"funnel"|"cone-funnel"|"pyramid"|"sankey"|"chord"|"sunburst"|"treemap"|"organization"|"wordcloud"series.tree / links / chord.matrix
仪表·地图"gauge"|"linear-gauge"|"pictogram"|"map"gauge:{min,max,target} / map:{topology} + 内置 WORLD_TOPOLOGY
混合系列series[].type 单独指定line + bar 组合图
水平方向direction: "horizontal" (柱状类)值轴切换到 x 轴

数据

功能开启方式API
类目轴categories: string[] / number[] / Date[]string=band, number=linear, Date=time 自动
替换数据—chart.setData(series, categories)
更新点位—chart.updatePoint(...) — 仪表盘等实时更新
按点样式series[].itemStyle: (ctx) => ({color?, name?})相当于 AG Charts itemStyler
误差线·趋势线series[].errors / series[].trendtrend: { type: "linear"|"movingAverage" }
分组类目categories: [[组, 叶子], …] 元组渲染第二行刻度

交互

功能开启方式API
图例legend: true | { position }点击切换 + hover dimming / toggleLegend / hoverLegend
图例复选框legend: { checkboxes: true }legendCheck 事件 { id, checked }
提示tooltip: "point"|"shared"|{ mode, format, render }shared 含十字线,render 可自定义 HTML
缩放·平移zoom: true | { wheel, pan, axes, select }setZoomWindow / resetZoom — 可选 x/y/xy 轴
刷选brush: true — 拖拽选择范围selectionChange 事件 / setSelection
导航器·滚动条navigator: true | scrollbar: true用迷你图或细缩放条控制窗口
下钻drilldown: { "标签": 子级 }drillDown/drillUp/drillUpAll + ‹Back 按钮
点选allowPointSelect: trueselectPoint / clearSelected, .mc-selected
右键菜单contextMenu: true | { items }内置缩放重置/SVG·PNG 导出 + 自定义项 menuAction
图表同步sync: "组键"同键图表共享 hover·缩放
触摸双指缩放自动(zoom 开启时)按双指间距以焦点锚定缩放
跟随系统主题自动跟踪 prefers-color-scheme — 系统切深色时同步图表变量

注释·导出·无障碍

功能开启方式API
注释绘制drawing: true + chart.setDrawMode(tool)line/hline/vline/rect/channel/fibonacci/measure + getDrawings
保存 SVG·PNGcontextMenu 内置或直接调用downloadSVG / downloadPNG export
迷你图—mountSparkline — 无轴迷你图
状态保存·恢复—getState / setState — 往返缩放·隐藏·注释
键盘导航自动 — 移动点位焦点含 aria-pressed 等无障碍属性
主题--chart-* CSS 变量 + 调色板循环通过 .mc-* 类 DOM 约定自定义
打印事件自动beforePrint / afterPrint 事件

场景配方

下钻

点击点位下钻到子级数据 — 自动提供‹Back按钮

new ChartCore({
  type: "bar",
  series: [{ name: "按月", values: [12, 24, 16] }],
  categories: ["1月", "2月", "3月"],
  drilldown: {
    "1月": {
      series: [{ name: "1月按周", values: [3, 4, 2, 3] }],
      categories: ["第1周", "第2周", "第3周", "第4周"],
      title: "1月每周销售",
    },
  },
});

chart.drillUp();   // 返回上一级

注释绘制 (annotations)

趋势线·斐波那契回撤·区间测量 — AG Charts付费级功能

chart.setDrawMode("fibonacci"); // 拖拽 → 0~100% 回撤位
chart.setDrawMode("channel");   // 平行通道 + 阴影带
chart.setDrawMode("measure");   // Δx/Δy 自动标签

chart.getDrawings();      // DrawingInput[](数据坐标)
chart.clearDrawings();
chart.setDrawMode(null);  // 解除(也可按 Esc)

实时数据

setData幂等 — 同引用重调用被忽略,响应式循环安全

setInterval(() => {
  series[0].values.push(rand()); series[0].values.shift();
  chart.setData(series, categories);   // 引用为新数组时重新渲染
}, 1000);

// 像仪表一样只改单个点位时
chart.updatePoint(seriesId, 0, nextValue);

图表同步 (sync)

同组键图表间共享hover·缩放 — 仪表盘多图表用

mountChart(elA, { type: "line", series, categories, sync: "dash" });
mountChart(elB, { type: "bar",  series, categories, sync: "dash" });

// 一侧缩放/悬停会以相同域基准传播到另一侧
// (传播的更改不再二次传播,无循环)

K线 (股价)

ohlc数据绘制涨跌K线 — 颜色用--chart-up/down-color变量

new ChartCore({
  type: "candlestick",
  categories: ["10/1", "10/2", "10/3"],
  series: [{
    name: "股价",
    ohlc: [
      [100, 108, 97, 105],   // [open, high, low, close]
      [105, 110, 101, 103],
      [103, 112, 102, 111],
    ],
  }],
});

世界地图 (choropleth)

内置Natural Earth 110m地形 — 仅代码关联,无轴地区图

import { WORLD_TOPOLOGY } from "@moda-chart/core"; // CDN 下为 window.ModaChart.WORLD_TOPOLOGY

new ChartCore({
  type: "map",
  series: [{
    name: "各国用户",
    mapData: { KOR: 92, JPN: 64, USA: 88, DEU: 40 },
  }],
  map: { topology: WORLD_TOPOLOGY, projection: "mercator" },
});
// 未关联区域为 .mc-map-no-data,右下角渐变图例

源码·文档

指南文档(图表类型总表、交互、主题变量、迁移映射)在公开仓库中维护。

park-taejoon/moda-chart-releases

使用方法

无头图表 — 下钻·同步·K线·地图。

chart library

相关工具