ModaChart — チャート
ヘッドレスチャート — ドリルダウン・同期・ローソク・地図。
35種のチャートタイプをReact・Vue・Svelte・素のJSどこでも同じように描くヘッドレスチャートライブラリ。
スケール計算・インタラクション・イベントなどすべてのロジックを純粋TypeScriptコアに置き、各フレームワークアダプタは薄い反応バインディングのみ担当します。全レンダラーが同じDOM契約を作るため結果は常に同じです。
ズーム・ナビゲーター・ドリルダウン・注釈描画・チャート同期など有償級の機能に加え、内蔵世界地図・スパークラインまで — バンドル約250KBと軽量です。
ライブデモ
CDNから読み込んだ実際のコアで動作します。ライン・棒・パイからキャンドル・サンキー・サンバースト・世界地図まで全チャートタイプを切替でき、凡例・ツールチップ・ズーム・ブラシ・ナビゲーター・ポイント選択・右クリックメニュー・ドリルダウン・注釈描画(トレンドライン/フィボナッチ/区間測定)を試せます。下のパネルには現在の設定を再現するコードがリアルタイム表示されます。
環境別パッケージ
| 使用環境 | パッケージ | 備考 |
|---|---|---|
| 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ストア連動 + 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.css3ステップで開始
- 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" (bar系) | 値軸が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: [[グループ, リーフ], …] タプル | 2行目のティックを描画 |
インタラクション
| 機能 | 有効化 | 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 有効時) | 指の間隔で焦点アンカーズーム |
| OSテーマ連動 | 自動 | prefers-color-scheme 変更を追跡 — OSダーク切替時にチャート変数を同期 |
注釈・エクスポート・アクセシビリティ
| 機能 | 有効化 | 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 等のa11y属性を含む |
| テーマ | --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(); // 1レベル戻る注釈描画 (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" });
// 片方でズーム/ホバーすると同じドメイン基準でもう片方へ伝播
// (伝播された変更は再伝播しないのでループなし)ローソク足 (株価)
ohlcデータで上昇/下落ローソク — 色は--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使い方
ヘッドレスチャート — ドリルダウン・同期・ローソク・地図。