ModaChart — チャート

ヘッドレスチャート — ドリルダウン・同期・ローソク・地図。

35種のチャートタイプをReact・Vue・Svelte・素のJSどこでも同じように描くヘッドレスチャートライブラリ。

スケール計算・インタラクション・イベントなどすべてのロジックを純粋TypeScriptコアに置き、各フレームワークアダプタは薄い反応バインディングのみ担当します。全レンダラーが同じDOM契約を作るため結果は常に同じです。

ズーム・ナビゲーター・ドリルダウン・注釈描画・チャート同期など有償級の機能に加え、内蔵世界地図・スパークラインまで — バンドル約250KBと軽量です。

無料 (MIT)React · Vue 3 · Vue 2.7 · Svelte 5 · Vanilla35種チャートSVG描画 · ~250KB

ライブデモ

CDNから読み込んだ実際のコアで動作します。ライン・棒・パイからキャンドル・サンキー・サンバースト・世界地図まで全チャートタイプを切替でき、凡例・ツールチップ・ズーム・ブラシ・ナビゲーター・ポイント選択・右クリックメニュー・ドリルダウン・注釈描画(トレンドライン/フィボナッチ/区間測定)を試せます。下のパネルには現在の設定を再現するコードがリアルタイム表示されます。

CDNからmoda-chartコアを読み込み中…

環境別パッケージ

使用環境パッケージ備考
React@moda-chart/reactChartViewコンポーネント + useChartCoreフック (useSyncExternalStore)
Vue 3@moda-chart/vueuseChart + ChartView, shallowRef基盤リアクティブ
Vue 2.7@moda-chart/vue2Vue 3と同じComposition API
Svelte 5@moda-chart/sveltereadableストア連動 + 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

3ステップで開始

  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" (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[].trendtrend: { 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: trueselectPoint / 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

使い方

ヘッドレスチャート — ドリルダウン・同期・ローソク・地図。

chart library

関連ツール