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/react | ChartView组件 + useChartCore钩 (useSyncExternalStore) |
| Vue 3 | @moda-chart/vue | useChart + ChartView, shallowRef响应式 |
| Vue 2.7 | @moda-chart/vue2 | 与Vue 3相同Composition API |
| Svelte 5 | @moda-chart/svelte | readable store联动 + ChartView |
| 纯JS / CDN | moda-chart.js | 无需构建,一行<script>,window.ModaChart |
| 无框架 | @moda-chart/core | 直接使用无头ChartCore + mountChart |
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 # 仅无头核心CDN 直接使用
https://chart.modaolive.com/moda-chart.jshttps://chart.modaolive.com/style.css三步开始
- 1
安装包
安装 npm i @moda-chart/react 等适配器,或用一行 CDN <script> 加载核心。
- 2
类型 + 数据
只需传 type 和 series·categories。points·ohlc·tree·links 等按类型的数据字段在需要时添加。
- 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[].trend | trend: { 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: true | selectPoint / 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·PNG | contextMenu 内置或直接调用 | 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