aerizchart

@aeriz/chartDOCS

26 種類のキャンバスチャートを、オプションオブジェクトひとつで描くライブラリです。使い方はひとつだけで、React · Vue · Svelte · jQuery でも名前とオプションは同じです。

v2.1.1 · チャート 1 種 12〜17 KB · 全体 35 KB(gzip)· 依存ゼロ

概要

@aeriz/chart は、26 種類の Canvas チャートをひとつのオプションオブジェクトで描きます。コンテナとデータを渡すだけで、軸・凡例・ツールチップ・アニメーション・テーマは既定値が引き受けます。

  • やり方はひとつ データは data、変更は update()、状態は setState()。26 種類・5 つの環境すべてで同じです。
  • 間違いを教えてくれる オプション名やデータの形が違うと、空の画面ではなくコンソールに直し方が出ます。
  • 使う分だけ チャートごとにモジュールが分かれているので、使うチャートだけがバンドルに入ります。ランタイム依存ゼロ。
  • どこでも バニラ JS、React、Vue、Svelte、jQuery で名前も使い方も同じです。
  • つなぎやすいイベント クリック・ホバー・凡例・ツールチップのボタンはすべて関数ひとつ。詳細画面・ポップアップ・ドリルダウンが数行で書けます。イベント
  • 高速 100 万点を約 50 ms で描画。画面外のチャートは描きません。

2.1.1 の新機能 ツールチップのリンク・ボタンと独自の内容、凡例クリックの差し替え、ポインター下の項目の取得。2.1 のコードはそのまま動きます。

2.1 の新機能 基準線・区間、ズーム・ブラシ、同期、100% 積み上げ、誤差棒、複数の値軸、そしてローソク足・ツリーマップ・サンバースト・サンキー・ネットワーク・地図。2.0 のコードはそのまま動きます。

サンプル

実際のプロダクト画面のように作ったサンプルです。すべてこのページ上で動いていて、JS・HTML・CSS タブにあるのがその画面のコードのすべてです。どのチャートも new SomeChart(element, { data }) にオプションをいくつか足すだけです。チャートの種類ごとの見た目はチャートの種類にあります。

売上ダッシュボード

@aeriz/chart · JS 38 行

KPI カード、複合チャート、ドーナツ、ヒートマップ、ファネルまで 8 つのチャート。どれもオプションはいくつかだけで、月別 · 四半期別の切り替えは update() 1 回です。

オンラインストア2026 年 1〜12 月
売上$13.92M▲ 18.4%
注文数312K▲ 11.0%
平均注文額$44.60▲ 6.7%
転換率3.0%▲ 0.4 pt

売上と利益率

販売チャネル

曜日 · 時間帯別の注文

購入ファネル

事業分析レポート · 複雑なチャート

@aeriz/chart · JS 97 行

右軸付きの 4 層複合チャート、積み上げ面、ARR ブリッジ、コホート継続率、四分位分布、20,000 点、8,760 マスのヒートマップまで 9 つのチャート。セグメントのボタンひとつで全部が update() されます。

サブスクリプション事業レポート 2026
読み込み中…

週別の新規登録 · 棒 + 面 + 線 + 点、右軸

新規登録(棒)と 8 週平均(面)は左軸、転換率(線)は右の % 軸です。赤い点は平均から大きく外れた週です。

チャネル別の獲得 · 積み上げ面

凡例をクリックするとチャネルが外れ、残りが積み直されます。

年間経常収益(ARR)ブリッジ

期首 ARR から新規・拡大・縮小・解約を経て期末まで。

登録月別のコホート継続率

まだ来ていない月は空のまま(null)です。

プラン別の利用時間

8,000 セッションから計算した四分位と外れ値。

競合比較

アンケート 6 項目、10 点満点。

ユーザー 20,000 人 · 利用日数と月額支出

プランごとに色分け。マウスを乗せると 1 人を選び出します。

プラン別ユーザー数

散布図と同じデータから数えています。

365 日 × 24 時間のトラフィック · 8,760 マス

週末と通勤時間帯が目立ちます。どのマスにもツールチップがあります。

ドリルダウン分析 · 100 万点

@aeriz/chart · JS 43 行

左の地域の棒をクリックすると、onClick が他のチャートをその地域に切り替え、1 秒単位の取引 1,000,000 件を作り直して描きます。かかった時間は上部にそのまま表示されます。

地域と店舗 読み込み中… 左の棒をクリックするか、チャートにフォーカスして ↑ ↓ Enter を使ってください。

地域別売上

ソウル · 月別売上(昨年比較)

ソウル · 24 店舗(面積 · 売上 · 従業員)

ソウル · 決済サーバー、1 秒ごとのサンプル 1,000,000 件(11 日 14 時間)

サーバー監視画面

@aeriz/chart · JS 23 行

0.1 秒ごとに値が流れるリアルタイムの線、ゲージ 3 つ、API ごとの応答時間。「障害を再現」を押してみてください。

api-prod · ソウルリージョン 正常

応答時間(0.1 秒ごと)

API 別 p95

アンケート結果レポート

@aeriz/chart · JS 18 行

同じチャートを白い紙の上に置くと、文字色と背景を読んで明るいテーマになります。ブランドカラーは CSS 変数 2 行です。

2026 年 顧客満足度調査 · 回答 1,284 件

サービス満足度レポート

総合満足度は 5 点満点中 4.3 点で、昨年より 0.4 点上がりました。すべての年代でスコアが上がり、配送の速さがいちばん大きく効いています。

項目別の満足度
年代別 · 昨年との比較
推奨意向

インストール

お使いのパッケージマネージャーを選んでください。ビルドなしで使う場合は CDN タブを見てください。

bash
npm install @aeriz/chart

npm パッケージには、minify 済みのビルド(dist/)と TypeScript の型だけが入っています。

  • import → チャートごとに分かれた dist/esm/
  • require → dist/aeriz.min.cjs
  • CDN のスクリプト → dist/aeriz.min.js

minify で短くするのはローカル変数名だけです。オプション名、メソッド、チャート名、エラーメッセージはそのまま読めます。

ヒント CDN の URL には @2.1.1 のように正確なバージョンを書きましょう。URL が変わらないので、1 年間キャッシュされます。

クイックスタート

必要なのは、高さのある要素とデータだけです。高さがない場合は 320px になります。

html
<div id="sales" style="height: 260px"></div>
<script type="module">
  import { BarChart } from '@aeriz/chart';

  const chart = new BarChart('#sales', {
    data: { Jan: 64, Feb: 42, Mar: 78, Apr: 55, May: 90, Jun: 71 },
  });

  chart.update({ data: { Jan: 30, Feb: 80 } }); // 新しい値へアニメーションする
</script>

棒にマウスを乗せるか、チャートにフォーカスして ← → で値を読んでみてください。

使い方はひとつ

どのチャートも同じ 4 つの呼び出しで使います。同じことを別の名前で行う方法はありません。

目的使うもの
作成new BarChart(element or selector, options)
データやオプションの変更chart.update({ data, … }) — 変わったものだけを渡す。値はアニメーションする
読み込み中 · 空 · エラーchart.setState('loading' | 'empty' | 'error', text?)。閉じるには chart.setState(null)
今すぐ描き直すchart.render() — CSS 変数を読み直し、画面外でも最終フレームをすぐに描く
削除chart.destroy() — 要素を元の状態に戻す

RealtimeChart だけは、値を流し込む push() と空にする clear() が加わります。

データの形

データは必ず data オプションひとつに入れます。形はチャートが描くものに合わせます。

項目ごとに値がひとつのチャート

Bar、HBar、Line、Sparkline、Pie、Polar、Funnel、Treemap、Sunburst、Map は、次の 3 つのどれでも受け取ります。意味はすべて同じです。

js
new BarChart(el, { data: [64, 42, 78] });                  // 数値 → ラベルは 1, 2, 3
new BarChart(el, { data: { Jan: 64, Feb: 42 } });          // オブジェクト → キーがラベル
new BarChart(el, { data: [{ label: 'Jan', value: 64 }] }); // 行

// フィールド名が違う行:読み方を指定する
new BarChart(el, { data: rows, label: (r) => r.month, value: (r) => r.sales });

シリーズが複数あるチャート

Area、StackedBar、GroupedBar、MultiLine、Radar、Composite は、data の中に categories と series を入れます。各シリーズの値の数は categories と同じにします。誤差棒や区間は、行やシリーズに low と high を足します(誤差棒)。

js
new GroupedBarChart(el, {
  data: {
    categories: ['Q1', 'Q2', 'Q3'],
    series: [
      { name: '2025', values: [120, 135, 150] },
      { name: '2026', values: [140, 160, 172] },
    ],
  },
});

そのほか

チャートdata
Scatter · Bubble[{ x, y, size?, group?, label? }] — Scatter の size は点の半径(px)、Bubble の size は泡の面積で表す値
Heatmap{ x: [...], y: [...], values: [[...], …] } — values[y][x]
Boxplot[{ label, min, q1, median, q3, max, outliers? }]
Waterfall[{ label, value, total? }] — total: true の棒は 0 からその値まで(小計・最終結果)
Gauge数値(data: 72)
Realtime{ series: [{ name }] } — 値は push() で届く
Candlestick[{ label, open, high, low, close }]
Treemap · Sunburst項目ごとに値ひとつ。children: [...] を持つ行は入れ子になる — 階層データ
Sankey{ links: [{ source, target, value }], nodes?: [{ id, label?, color? }] }
Network{ nodes: [{ id, label?, group?, size? }], links: [{ source, target, value? }] }
Map項目ごとに値ひとつ(ラベルは地域の id)。地図は geo オプションで渡す — 地図

間違えると教えてくれます

オプションの間違いや読めないデータの形が、黙って空のチャートになることはありません。ブラウザーのコンソールが、何が違うか・どう直すかをメッセージごとに 1 回だけ伝えます。

text
[aeriz] BarChart: unknown option "dat" — did you mean "data"?
[aeriz] BarChart: "color" is a 1.x option. In 2.0 use colors.
[aeriz] MultiLineChart: data must be { categories: [...], series: [{ name, values: [...] }] } — got an array.
[aeriz] MultiLineChart: series[1] "Sign-ups" has 5 values but there are 6 categories.
[aeriz] LineChart: rows need a "value" field, or pass value: (row) => row.amount.
[aeriz] PieChart: values can't be negative — "Refunds" is -3. It is drawn as 0.
[aeriz] BarChart: "zoom" is not available on this chart — it works on LineChart, MultiLineChart, AreaChart, CompositeChart, CandlestickChart and ScatterChart.
[aeriz] MapChart: 3 rows match no region (e.g. "Korea"). Keys are feature ids, or properties.name when a feature has no id.

削除されたメソッドを呼ぶと、代わりの方法を添えて例外を投げます(chart.setData() was removed. Use chart.update({ data }).)。TypeScript なら、同じ間違いをエディターが先に見つけます。

使うものだけ読み込む

チャートはそれぞれ独立したモジュールで、パッケージには "sideEffects": false が付いているので、バンドラー(Vite、webpack、Rollup、esbuild)は使わないチャートを取り除きます。いつもどおり import するだけです。React・Vue・Svelte のアダプターからでも同じです。

js
import { BarChart, PieChart } from '@aeriz/chart'; // この 2 つと共通コアだけ

バンドラーを使わない場合や、確実にひとつのチャートだけを読み込みたい場合は、サブパスから import します。

js
import { BarChart } from '@aeriz/chart/bar';
import { SparklineChart } from '@aeriz/chart/sparkline';
読み込むものサイズ(min + gzip)
軸のないチャートひとつ(Gauge、Pie、Funnel …)約 12 KB
階層・フロー・地図のチャートひとつ(Treemap、Sunburst、Sankey、Network、Map)約 12〜13 KB
軸のあるチャートひとつ(Bar、Line、Composite …)約 14〜17 KB
Bar + Line + Pie約 18 KB
全 26 種類約 35 KB(CDN の aeriz.min.js は約 38 KB)
ズーム · 同期(zoom か sync を初めて使うときに別途読み込み)約 3 KB
ツールチップのリンク・ボタン・独自の内容(tooltip: { … } を初めて使うときに別途読み込み)約 2.4 KB
React · Vue · Svelte · jQuery アダプターそれぞれ 0.3〜0.7 KB

esbuild で計測。共通コア(Canvas、テーマ、ツールチップ、凡例、入力、間違いの警告)は全チャートで共有するので、チャートを増やしてもサイズはあまり増えません。

サブパス:bar hbar line area stacked-bar grouped-bar multi-line scatter bubble pie radar polar gauge heatmap boxplot funnel treemap sparkline realtime waterfall composite candlestick sunburst sankey network map

バニラ JS

5 つの環境はすべて同じチャート名とオプションを使います。フレームワークなしなら、クラスをそのまま使います。

js
import { LineChart } from '@aeriz/chart';

const chart = new LineChart('#trend', { data: [3, 7, 4, 9, 6, 12] });
chart.update({ data: [5, 8, 6, 11] });
chart.destroy(); // 要素がページから外れるとき

React

@aeriz/chart/react からチャート名と同じコンポーネントを import します。オプションはすべて props です。React 16.8 以降で動作します。

jsx
import { useRef } from 'react';
import { BarChart } from '@aeriz/chart/react';

export function Sales({ rows }) {
  const chart = useRef(null); // chart.current = チャートのインスタンス
  return (
    <BarChart
      data={rows}
      format={{ style: 'currency', currency: 'USD' }}
      onClick={(hit) => console.log(hit.label, hit.value)}
      ref={chart}
      style={{ height: 320 }}
    />
  );
}
  • 変わった props は update() を呼びます。毎回のレンダーで作り直されるインラインのオブジェクトや関数は、値が同じなら描き直しません。
  • 配列は参照で比較します。データを変えるときは新しい配列を渡してください([...rows, row])。
  • className、style、id、aria-*、data-* はラッパーの <div> に付きます。StrictMode でもチャートはひとつだけ作られます。

Vue

@aeriz/chart/vue からチャート名と同じコンポーネントを import します。オプションは props で、onClick・onHover・onLegend・onZoom はイベント @click・@hover・@legend・@zoom になります。Vue 3.2 以降で動作します。

vue
<script setup>
import { ref } from 'vue';
import { LineChart } from '@aeriz/chart/vue';

const rows = ref([3, 7, 4, 9]);
const add = () => (rows.value = [...rows.value, Math.random() * 10]);
const trend = ref(null); // trend.value.chart = チャートのインスタンス
</script>

<template>
  <LineChart :data="rows" curve="linear" @click="(hit) => console.log(hit)" ref="trend" style="height: 300px" />
</template>

Vue のリアクティブなプロキシはチャートに渡る前に外すので、大きなデータでも速いままです。データは新しい値で置き換えてください。その場での変更(rows.value.push())は検知されません。

Svelte

@aeriz/chart/svelte にはチャートごとのアクション(barChart、lineChart、multiLineChart …)があり、パラメーターがオプションです。コンパイラーの設定は不要で、Svelte 3・4・5 で同じです。

html
<script>
  import { barChart, chartOf } from '@aeriz/chart/svelte';

  let rows = $state([{ label: 'A', value: 5 }, { label: 'B', value: 9 }]);
</script>

<div use:barChart={{ data: rows, onClick: (hit) => console.log(hit) }} style="height: 300px"></div>

チャートのインスタンスが必要なときは chartOf(element) を使います。

jQuery

使うチャートを install($, { … }) で登録し、サブパス名('bar'、'pie' …)で作成します。CDN のスクリプト(aeriz.min.js)は、先に jQuery を読み込んでおけば 26 種類すべてを自動で登録します。

js
import $ from 'jquery';
import { PieChart } from '@aeriz/chart/pie';
import { install } from '@aeriz/chart/jquery';

install($, { PieChart });
$('#share').aerizChart('pie', { data: { Chrome: 64, Safari: 19 }, innerRadius: 0.6 });
js
$('#share').aerizChart('update', { data: { Chrome: 70, Safari: 20 } }); // setState · render · destroy も同じ書き方
$('#share').aerizChart('instance');                                       // チャートのインスタンス

実際に動いています。凡例をクリックすると、シリーズを非表示・表示に切り替えられます。

MultiLineChart
StackedBarChart
PieChart · innerRadius
CompositeChart · 右軸
RadarChart
HeatmapChart
TreemapChart · children
WaterfallChart
GaugeChart
CandlestickChart
SunburstChart
SankeyChart
クラスサブパスdata特徴
BarChartbar項目ごとに値ひとつ負の値は下へ伸びる、dataLabels
HBarCharthbar項目ごとに値ひとつ横向き、ラベル欄はラベルに合わせた幅
LineChartline項目ごとに値ひとつcurve、時間軸、対数軸、100 万点、ズーム、区間
AreaChartareacategories · seriesstacked('percent')、ズーム
StackedBarChartstacked-barcategories · series負の値は下へ積み上げ、stacked: 'percent'
GroupedBarChartgrouped-barcategories · seriesシリーズを横に並べる、誤差棒
MultiLineChartmulti-linecategories · seriesポインターに追従する共通ツールチップ、ズーム、区間
ScatterChartscatter[{ x, y }]色とサイズごとにまとめて描画、ズーム
BubbleChartbubble[{ x, y, size }]size は面積
PieChartpie項目ごとに値ひとつinnerRadius でドーナツ、凡例から扇形を切り替え
RadarChartradarcategories · series点ごとのツールチップ
PolarChartpolar項目ごとに値ひとつ面積が値に比例(半径にするなら scale: 'linear')
GaugeChartgauge数値update({ data }) は表示中の値から動く
HeatmapChartheatmap{ x, y, values }colors: { low, high }
BoxplotChartboxplot[{ min, q1, median, q3, max }]外れ値の点
FunnelChartfunnel項目ごとに値ひとつ最初の段階からの転換率
TreemapCharttreemap項目ごとに値ひとつ(+ children)正方形に近い配置。グループには見出しが付く
SparklineChartsparkline項目ごとに値ひとつ軸のない小さなトレンド線
RealtimeChartrealtime{ series } + push()固定幅の窓の中を流れる
WaterfallChartwaterfall[{ label, value, total? }]累計
CompositeChartcompositecategories · series(type)棒・線・面・点の組み合わせ、複数の値軸、積み上げ棒、ズーム
CandlestickChartcandlestick[{ label, open, high, low, close }]価格に合わせた軸、ズーム、数万本のローソク足
SunburstChartsunburst項目ごとに値ひとつ(+ children)階層ごとにリング 1 本、中央に割合
SankeyChartsankey{ links, nodes? }値に比例した太さの流れの帯
NetworkChartnetwork{ nodes, links }力学レイアウト、隣接ノードのハイライト
MapChartmap項目ごとに値ひとつ + geoGeoJSON の地域を色分け、scale: 'log'

ローソク足

期間ごとの始値・高値・安値・終値を描きます。実体は始値から終値まで(上がったときは colors.up、下がったときは colors.down)、ひげは安値から高値までです。値軸は 0 からではなく、表示中の価格に合わせます。

js
new CandlestickChart('#stock', {
  data: candles,                   // [{ label, open, high, low, close }]
  zoom: true,
  range: ['7/29', '10/22'],        // 最初は直近 3 か月を表示
  annotations: [{ y: 80, label: 'Target $80' }],
  // 赤が上昇を表す市場では colors: { up: '#ef4444', down: '#3b82f6' }
});

ドラッグで拡大、Shift を押しながらドラッグするか横スクロールで移動します。ダブルクリックで全体を表示します。

ローソク足が 3px より細くなるとひげだけを描き、ポインターはピクセル列ごとに最も近い足を探します。そのため数万本でも軽く動きます。x 軸はラベル('8/3')か、ミリ秒のタイムスタンプと xScale: 'time' を受け取ります。始値や終値が安値〜高値の範囲を外れていると、コンソールに表示されます。

階層 — ツリーマップ · サンバースト

TreemapChart と SunburstChart は同じデータを受け取ります。children を持つ行はグループになり、グループの値は子の合計です。深さに制限はありません。

js
const budget = [
  { label: 'Engineering', children: [{ label: 'Backend', value: 42 }, { label: 'Apps', value: 30 }, { label: 'Data', value: 18 }] },
  { label: 'Marketing', children: [{ label: 'Ads', value: 25 }, { label: 'Events', value: 9 }, { label: 'Content', value: 7 }] },
  { label: 'Operations', children: [{ label: 'Support', value: 14 }, { label: 'Office', value: 8 }] },
  { label: 'Other', value: 6 },
];
new TreemapChart('#budget-tree', { data: budget, onClick: (hit) => console.log(hit.path) }); // ['Engineering', 'Backend']
new SunburstChart('#budget-sun', { data: budget });
TreemapChart · children
SunburstChart
  • ツリーマップは各グループに名前と合計の見出しを付け、その中に子を並べます。子のないフラットなデータ({ JS: 42, TS: 30 })は 2.0 とまったく同じに描かれます。
  • サンバーストは最初の階層を内側のリングに置き、子は親の角度の中に収まります。スライスにマウスを乗せるとその枝だけが明るく残り、中央に全体に対する割合が出ます。
  • ツールチップには最上位からのパス(Engineering › Backend: $42M)が出て、onClick でも同じパスを hit.path として受け取れます。

流れ — サンキー

段階間の流れを、値に比例した太さの帯で描きます。ノードはリンクから作られ、始点からの最長経路の分だけ右の列に置かれます。出ていく流れのないノードは最後の列に並びます。

js
new SankeyChart('#journey', {
  data: {
    links: [
      { source: 'Search', target: 'Product page', value: 520 },
      { source: 'Ads', target: 'Product page', value: 300 },
      { source: 'Product page', target: 'Cart', value: 410 },
      { source: 'Cart', target: 'Purchase', value: 330 },
      // …
    ],
    nodes: [{ id: 'Purchase', color: '#10b981' }], // ラベルや色を変えたいときだけ
  },
});

循環する(サイクルになる)リンクはサンキーでは描けないので除外され、コンソールにそのリンクが表示されます。帯やノードにマウスを乗せるとその流れがハイライトされ、onClick の hit.row はリンクの行(ノードならノードの行)です。

関係 — ネットワーク

力学レイアウトでノードとリンクを配置します。リンクは両端を引き寄せ、ノード同士は反発し合い、最初の 1 秒ほどで落ち着きます。animate: false や render() を使うと、落ち着いた配置をすぐに描きます。

js
new NetworkChart('#services', {
  data: {
    nodes: [{ id: 'web', group: 0 }, { id: 'gateway', group: 1, size: 120 }, …], // group: 色、size: 面積
    links: [{ source: 'web', target: 'gateway', value: 80 }, …],               // value: 太さ
  },
  radius: [4, 14], // 最小・最大の size に対応する半径(px)
});

ノードにマウスを乗せると、隣接するもの以外が薄くなります。

ノードが 40 個以下ならすべてのラベルを表示し、それより多いとマウスを乗せたノードの周辺だけを表示します。update() で新しいデータを渡すと、残るノードはその場にとどまり、新しいノードだけが場所を探します。存在しないノードを指すリンクはコンソールに表示されます。

地図

地域を値で色分けします。パッケージに地図データは含まれていないので、GeoJSON を geo に渡します。地域は feature の id で、id がなければ properties.name で探します。

js
const geo = await fetch('/data/world-110m.json').then((r) => r.json());

new MapChart('#world', {
  geo,                                          // FeatureCollection(Polygon · MultiPolygon、経度/緯度)
  data: { KOR: 31846, JPN: 40247, USA: 65298 }, // 地域 id → 値(行 [{ label, value }] でも可)
  scale: 'log',                                 // 値が一方に偏るとき(人口、GDP など)
  format: { style: 'currency', currency: 'USD', notation: 'compact' },
});

国別の 1 人あたり GDP(2019 年、Natural Earth)。ツールチップの国名は properties.name から取っています。

  • 投影法は projection: 'mercator'(既定)と 'equirectangular' です。地図はサイズごとに一度だけ投影され、ポインターは穴や島を含む実際の形に沿って判定します。
  • 色は colors: { low, high } で指定し、値のない地域は薄いグレーになります。地図の下に色の凡例が付きます(legend: false で非表示)。
  • どの地域にも一致しない行があると、コンソールに件数と例が表示されます("KOR" のつもりで "Korea" と書いていないか確認してください)。labelFormat: (id) => name でツールチップの地域名を変えられます。
  • このページの世界地図は world-110m.json(gzip で 41 KB)です。Natural Earth 1:110m(パブリックドメイン)を 0.1° 単位に丸めました。id は ISO 3166-1 alpha-3 コードで、properties には英語名(name)、韓国語名(ko)、1 人あたり GDP(gdp)が入っています。南極は除いています。

リアルタイムデータ

RealtimeChart に push() した値は右端に現れ、window を超えた値は左端から消えます。

js
const rt = new RealtimeChart('#cpu', { data: { series: [{ name: 'CPU' }, { name: 'Memory' }] }, window: 120, max: 100 });
setInterval(() => rt.push([cpu(), memory()]), 100);

大量データ

LineChart の点がピクセル数よりはるかに多いときは、ピクセル列ごとに最小値と最大値だけを残します。形は変わらず、ツールチップには元の点が出ます。結果はデータが変わるまで使い回すので、マウスを動かしても再計算しません。

ボタンを押すとデータを作り、描画時間を測ります。

基準線 · 目標線 · 区間

値軸のあるチャートは annotations から線と帯を描きます。値ひとつなら破線、[from, to] なら帯です。y は値軸に、x は x 軸(ラベル・時間・数値)に置かれます。

js
new LineChart('#latency', {
  data: latency, // 1 時間ごとの応答時間
  annotations: [
    { y: 300, label: 'SLO 300 ms', color: '#ef4444' }, // 目標線
    { y: [80, 160], label: 'Normal range' },          // 帯
    { x: '14:00', label: 'Deploy' },                  // 縦の基準線
  ],
});
  • Bar、HBar、Line、Area、StackedBar、GroupedBar、MultiLine、Scatter、Bubble、Boxplot、Waterfall、Composite、Candlestick、Realtime(y のみ)で使えます。それ以外のチャートではコンソールにその旨が表示されます。
  • 値軸上の線や帯は、必要なら軸を広げてでも見えるようにします。label は横線なら右端の上(線が最上部にあるときは下)、縦線なら上端に置かれます。color は線・帯・文字に使われます(既定は薄い文字色)。
  • HBarChart は値軸が横向きなので、x が値、y が項目ラベルです。CompositeChart では axis で線を置く値軸を選びます(値軸を増やす)。
  • update({ annotations }) はアニメーションなしで線だけを描き直します。

ズーム · パン · ブラシ

zoom: true にすると x 軸を拡大・移動できます。LineChart、MultiLineChart、AreaChart、CompositeChart、CandlestickChart、ScatterChart で使えます。拡大中は値軸が表示中のデータに合わせます(棒や面のある軸は 0 から始まります)。

js
const chart = new LineChart('#visits', {
  data: visits,                           // [{ label: 時刻(ms), value }]
  xScale: 'time',
  zoom: true,
  range: [from, to],                      // 最初に表示する範囲(省略時は全体)
  onZoom: (range) => console.log(range), // ユーザーが変えるたびに [from, to] か null
});

chart.update({ range: null }); // コードから全体表示に戻す

チャートの上をドラッグしてみてください。

マウス · トラックパッドタッチキーボード(チャートにフォーカス)
拡大ドラッグで範囲を選択 · Ctrl/⌘ + ホイール · ピンチ2 本指で広げる+
縮小Ctrl/⌘ + ホイール · ピンチ2 本指でつまむ-
移動Shift + ドラッグ · 横スクロール拡大中に 1 本指でドラッグShift + ← →
リセットダブルクリック · 右上のボタン右上のボタン0

普通のホイールはページをスクロールし、拡大していないチャートを 1 本指でドラッグするとツールチップが出るので、ページのスクロールを妨げることはありません。range は x 軸の単位で指定します。ラベル軸なら ['Mar', 'May']、時間軸ならミリ秒、数値軸(Scatter)なら数値です。zoom なしの range は、その範囲を表示するだけです。

普段は軽いまま ドラッグ・ピンチ・同期のコード(約 3 KB)は、zoom か sync のあるチャートを初めて作ったときに別途読み込まれます。ズームしないチャートでは読み込まれません。

ブラシ

zoom: 'brush' のチャートは常に全体を表示し、そこでドラッグした範囲が同じ sync グループのチャートで拡大表示されます。選択範囲の端をドラッグすると大きさが変わり、内側をドラッグすると移動します。

js
new LineChart('#detail', { data, xScale: 'time', sync: 'traffic' });
new LineChart('#overview', { data, xScale: 'time', sync: 'traffic', zoom: 'brush', range: [from, to] });

チャートの同期

sync の名前が同じチャートは、クロスヘアとズーム範囲を共有します。同じ x の値(ラベル・時間・数値)で合わせるので、チャートの種類やデータの長さが違っても構いません。

js
new MultiLineChart('#requests', { data: requests, sync: 'ops', zoom: true });
new AreaChart('#errors', { data: errors, sync: 'ops', zoom: true, stacked: true });
new CompositeChart('#cost', { data: cost, sync: 'ops', zoom: true });

どれかのチャートにマウスを乗せるか、ドラッグで拡大すると、残りの 2 つも追従します。

  • ツールチップはポインターの下のチャートにだけ出ます。他のチャートは同じ位置にクロスヘア(MultiLine · Composite)、または破線と最も近い項目のハイライト(その他)を表示します。
  • 後からグループに加わったチャートはグループの現在の範囲から始まり、自分の range を持って加わるとそれがグループに渡されます。update({ sync: null }) でグループから抜けます。
  • onZoom はユーザーが操作したチャートでだけ呼ばれるので、グループごとに一度処理すれば十分です。

積み上げ · 100% 積み上げ

stacked: 'percent' は項目ごとの合計を 100% として割合を積み上げます。値軸は 0〜100% になり、ツールチップには元の値と並べて割合が出ます。

js
new StackedBarChart(el, { data, stacked: 'percent' }); // 既定は true(値をそのまま)
new AreaChart(el, { data, stacked: 'percent' });       // true · false · 'percent'
new CompositeChart(el, { data, stacked: true });       // 同じ軸の棒('percent' も可)
StackedBarChart · stacked: 'percent'
AreaChart · stacked: 'percent'

100% 積み上げは正の値の割合なので、負の値は 0 として扱い、コンソールにその旨が出ます。StackedBarChart は常に積み上げるため、stacked には true(既定)と 'percent' だけを指定できます。

誤差棒 · 信頼区間

行に low と high を加えると、棒には誤差棒、線には帯が付きます。シリーズのデータには値と同じ数の low・high 配列を渡します。値軸は区間全体が見えるように広がり、ツールチップは value (low – high) の形で表示します。

js
new BarChart(el, { data: [{ label: 'A', value: 0.031, low: 0.027, high: 0.035 }, …] });
new LineChart(el, { data: forecast }); // [{ label, value, low, high }] → 線 + 帯

new GroupedBarChart(el, {
  data: { categories, series: [{ name: '2026', values, low: [...], high: [...] }] },
});
BarChart · 誤差棒
LineChart · 予測区間

BarChart と LineChart は行で、GroupedBarChart・MultiLineChart・CompositeChart はシリーズで受け取ります(Composite は棒と点に誤差棒、線と面に帯を描きます)。それ以外のチャートでは、使わずに無視したことがコンソールに表示されます。

値軸を増やす · 積み上げ複合

CompositeChart のシリーズに axis の名前を付けると、名前ごとに値軸ができます。'left'(既定)は左側、それ以外の名前は出てきた順に右側に並び、同じ名前のシリーズは軸を共有します。stacked は同じ軸の棒を積み上げます。

js
new CompositeChart('#business', {
  stacked: true,
  data: {
    categories: ['Jan', 'Feb', 'Mar', …],
    series: [
      { type: 'bar', name: 'Online', values: online },  // 左の軸
      { type: 'bar', name: 'Store', values: store },    // 同じ軸なので上に積まれる
      { type: 'line', name: 'Margin', values: margin, axis: 'margin', format: { style: 'percent' } },
      { type: 'line', name: 'Visitors', values: visitors, axis: 'visitors' },
    ],
  },
});
  • 軸が複数あるとき、シリーズをひとつだけ持つ軸は目盛りのラベルがそのシリーズの色になるので、どの線の軸かがすぐわかります。
  • 軸の数値はそのシリーズの format で表示します。min と max は左の軸に適用され、他の軸はデータに合わせます。
  • 2.0 の axis: 'right' もそのまま動きます。'right' も名前のひとつにすぎません。

イベント早見表

チャートのイベントはすべてオプションとして渡す関数です。イベント名の文字列や addEventListener はなく、26 種類すべてで名前と引数が同じです。関数は update({ onClick }) でいつでも差し替えられ、アニメーションはやり直しません。

オプション呼ばれるとき使い道
onClick(hit, chart)項目をクリックしたとき、またはフォーカス中のチャートで Enter を押したとき詳細ページやポップアップを開く、ドリルダウン
onHover(hit, chart)ポインターの下の項目が変わったとき。離れると hit は nullサイドパネル、表の同じ行のハイライト
onLegend(index, visible, chart, event)凡例の項目をクリックしたとき(切り替わる前)event.preventDefault() で切り替えの代わりに別の動作をする
onZoom(range, chart)ユーザーが範囲を変えたとき範囲を URL に残す、他のビューと揃える — ズーム
tooltip.actions(hit, chart)ツールチップを作るとき(項目ごとに 1 回)ツールチップ下部のリンクとボタン
tooltip.render(hit, chart)ツールチップを作るとき(項目ごとに 1 回)ツールチップの中身を自作

hit はどこでも同じ形です。index(データ内の位置)、label、value、series(シリーズの番号)、row(渡した項目そのもの)、階層チャートでは path(最上位からの名前)を持ちます。id など行に入れておいた他の値は hit.row にあります。名前はどのフレームワークでも同じです。

js
new BarChart(el, { data: rows, onClick: open, onHover: show, tooltip: { actions } });

React で毎回のレンダーごとに新しい関数や tooltip オブジェクトを渡しても、チャートは描き直されません。

ツールチップのリンクとボタン

tooltip.actions が返すリストはツールチップの下部に並びます。href があればリンク、onClick だけならボタンです。クリックすると先に onClick(hit, chart, event) が実行され、そのあとツールチップが閉じます。ポップアップやサイドパネル、別ページはこの関数から開きます。

js
new HeatmapChart('#orders', {
  data: { x: hours, y: days, values },             // 曜日 × 時間帯ごとの注文数
  tooltip: {
    actions: (hit) => [
      { label: '注文一覧', href: `/orders?day=${hit.row.y}&hour=${hit.row.x}` },
      { label: '8 週間の推移', onClick: (hit) => openTrend(hit) }, // モーダルでもパネルでも何でも
    ],
  },
});

セルを指してから、ツールチップのボタンまでマウスを動かしてみてください。途中で他のセルを通ってもツールチップは動きません。

  • ルーターを使うアプリ href はそのまま残し(新しいタブで開く・アドレスのコピー用)、onClick で event.preventDefault() の後に router.push(href)。
  • 新しいタブ target: '_blank'。rel="noopener" は自動で付きます。
  • ブロックするアドレス javascript: のアドレスはブロックし、コンソールが onClick を使うよう案内します。

マウスを待つツールチップ

リンクやボタンのあるツールチップは、マウスがたどり着くまで待ちます。設定は不要で、リンクやボタンのないツールチップはこれまでどおりすぐマウスに追従します。

  • 移動中 — マウスがツールチップに向かう間、通過した項目は無視されます。途中で 0.3 秒止まると、その下の項目に切り替わります。
  • 離れたとき — チャートやツールチップから出ると 0.3 秒後に閉じるので、一瞬はみ出しても大丈夫です。
  • キーボード — ← → で項目を選ぶとツールチップが開き、Tab でその中のリンクやボタンに移動します。Esc でツールチップを閉じてチャートに戻ります。
  • タッチ — タップでツールチップが開き、ボタンはすぐにタップできます。他の場所をタップすると閉じます。
  • スクリーンリーダー — リンクやボタンのあるツールチップは読み上げて操作できる領域になり、ないものはこれまでどおりチャートが読み上げます。

ツールチップの中身を自作する

tooltip.render(hit, chart) が返したものがツールチップになります。項目ごとに 1 回だけ呼ばれ、マウスが同じ項目の上にいる間は呼ばれません。actions も指定すると、リンクとボタンはその下に並びます。

戻り値ツールチップ
文字列か数値そのテキスト(HTML として解釈されることはない)
DOM ノードそのノードをそのまま表示。中にリンクやボタンがあれば、マウスを待つツールチップになる
nullこの項目ではツールチップを出さない
undefined通常のツールチップ
js
const card = document.querySelector('#store-card');       // <template> 要素

new BarChart('#stores', {
  data: stores,                                            // [{ label, value, target, manager }]
  tooltip: {
    render: (hit) => {
      const el = card.content.firstElementChild.cloneNode(true);
      el.querySelector('.name').textContent = hit.label;    // データは textContent で入れる
      el.querySelector('.meter i').style.width = `${(hit.value / hit.row.target) * 100}%`;
      return el;
    },
    actions: (hit) => [{ label: '店舗ページ', href: `/stores/${hit.row.id}` }],
  },
});

棒を指すと店舗カードが表示されます。

  • 文字列 常にテキストとして表示されるので、データにタグが混ざっていても安全です。
  • HTML DOM ノードを返してください。<template> を複製し、データは textContent で入れるのが手軽です。HTML 文字列はそのままテキストとして表示され、コンソールがノードを返すよう案内します。
  • 色 背景色と文字色はテーマ(--aeriz-tooltip-bg · --aeriz-tooltip-fg)に従います。

クリックでドリルダウン

onClick から update({ data }) を呼べば、それがドリルダウンです。新しいデータはアニメーションで入れ替わり、キーボードでは Enter で同じことができます。

js
const chart = new BarChart('#sales', {
  data: regions,                         // [{ label: 'West', value: 412, children: [...] }, ...]
  onClick: (hit) => {
    if (hit.row.children) chart.update({ data: hit.row.children });
  },
});

棒をクリックすると地域 → 都市 → 店舗と進み、上のパスをクリックすると戻ります。

凡例のイベント

凡例をクリックすると、状態が変わる前に onLegend(index, visible, chart, event) が呼ばれます。

  • visible — 既定の動作どおりならその項目が取る状態。最後のひとつは非表示にできないので true です。
  • event.preventDefault() — 既定の動作(表示・非表示の切り替え)を止めます。
  • event.target — クリックされた凡例のボタン。

何が隠れているかは hidden オプション(隠す凡例項目の位置)が表します。最初から指定するか update({ hidden }) で変えます。凡例のクリックでも chart.options.hidden が更新されるので、保存しておけば次回も同じ状態で開けます。

js
new MultiLineChart('#traffic', {
  data: { categories, series },
  hidden: [3],                                    // 4 番目のシリーズを隠した状態で始める
  onLegend: (i, visible, chart, event) => {
    event.preventDefault();                       // 表示・非表示の代わりに、これだけ表示。もう一度クリックで全部
    const others = series.map((_, j) => j).filter((j) => j !== i);
    const alone = String(chart.options.hidden) === String(others);
    chart.update({ hidden: alone ? [] : others });
  },
});

凡例項目の位置にメニューを開くには、event.target の位置を使います。下のデモでは凡例をクリックするとメニューが開き、そのメニューが hidden を変えます。メニューはブラウザーの popover なので、外側をクリックするか Esc で閉じます。

js
onLegend: (i, visible, chart, event) => {
  event.preventDefault();
  const r = event.target.getBoundingClientRect();  // 凡例のボタン
  menu.style.left = `${r.left}px`;
  menu.style.top = `${r.bottom + 4}px`;
  menu.showPopover();                             // <div popover> … </div>
},

凡例をクリックすると、表示・非表示の代わりにメニューが開きます。キーボードでは Tab で凡例に移動して Enter を押します。

凡例を自作する

legend: false で内蔵の凡例を消し、好きな凡例を作って update({ hidden }) につなぎます。値と割合のリスト、チェックボックス、表の行など何でも構いません。onHover を加えれば、ポインターの下の項目を自作の凡例でも光らせられます。

js
const chart = new PieChart('#share', {
  data: browsers, colors, innerRadius: 0.6, legend: false,
  onHover: (hit) => highlight(hit?.index),        // ポインターが離れると hit は null
});

list.onclick = (e) => {
  const i = +e.target.closest('button').dataset.i;
  const hidden = chart.options.hidden ?? [];
  chart.update({ hidden: hidden.includes(i) ? hidden.filter((j) => j !== i) : [...hidden, i] });
};

    右のリストをクリックすると表示・非表示が切り替わります。扇形を指すと、その行が光ります。

    ポインターの位置を追う

    onHover(hit, chart) はポインターの下の項目が変わるたびに 1 回呼ばれ、ポインターがチャートを離れると null で呼ばれます。マウス・タッチ・キーボード(← →)で同じように動きます。ツールチップの代わりにサイドパネルに詳細を出したり、表の同じ行をハイライトしたり、他のビューと揃えたりするのに使います。

    js
    new CompositeChart('#revenue', {
      data: { categories: months, series: [thisYear, lastYear] },
      tooltip: false,                                 // ツールチップの代わりにサイドパネル
      onHover: (hit) => (hit ? showMonth(hit.index) : showYear()),
    });

    チャートの上でマウスを動かしてみてください。離れるとパネルは年間合計に戻ります。

    • クロスヘアのチャート(MultiLine、Composite、Realtime)は x 軸上の一点を指すので、hit には index と label しかありません。値は index を使ってデータから読みます。
    • sync でつながったチャートでは、ユーザーが指しているチャートだけが onHover を呼びます。追従するクロスヘアでは呼ばれません。

    テーマ

    設定しなくても、チャートは要素の文字色・フォント・背景を読み取り、そこからグリッドや軸の色を作ります。そのため明るいページにも暗いページにもそのままなじみ、OS のダークモードが切り替わるとテーマを読み直します。変えたいものだけを CSS 変数で上書きしてください。

    css
    .dashboard {
      --aeriz-color-1: #64c8ff;   /* パレット: --aeriz-color-1 … 12 */
      --aeriz-color-2: #10b981;
      --aeriz-text: #e7eef5;       /* 既定: 要素の color */
      --aeriz-grid: rgba(100, 200, 255, 0.08);
      --aeriz-font: 'Inter', sans-serif; /* 既定: 要素の font-family */
      --aeriz-font-size: 12px;
      --aeriz-line-width: 2;
      --aeriz-bar-radius: 4;
      --aeriz-tooltip-bg: rgba(0, 0, 0, 0.9);
    }

    スクリプトで変数を変えたら chart.render() を呼びます。チャートひとつだけ色を変えるなら colors: ['#f00', '#0f0'] オプションを、棒 1 本だけなら行に color を指定します。

    変数既定値
    --aeriz-text要素の文字色
    --aeriz-muted · --aeriz-grid · --aeriz-axis文字色の 62% · 9% · 30%
    --aeriz-bg最も近い不透明な背景
    --aeriz-font · --aeriz-font-size要素のフォント · 11
    --aeriz-accent#64c8ff(読み込みスピナー)
    --aeriz-line-width · --aeriz-point-radius · --aeriz-bar-radius2 · 3 · 3
    --aeriz-tooltip-bg · --aeriz-tooltip-fg暗い背景 · 白い文字
    --aeriz-surfacetransparent(キャンバスの背景)
    --aeriz-color-1 … 12PALETTE の 8 色

    数値とラベルの書式

    format は値(ツールチップと値軸)、labelFormat はラベル(x 軸のラベルとツールチップのタイトル)の書式です。軸ごとの書式オプションはありません。

    js
    { format: { style: 'currency', currency: 'USD' } }      // $1,234.00
    { format: { style: 'percent' } }                         // 0.25 → 25%
    { format: (v) => v.toFixed(1) + '°C' }                   // 関数
    { labelFormat: (t) => new Date(t).getHours() + 'h' }     // 時間軸のラベル
    • 既定値 ツールチップは 3 桁区切り、軸は 10,000 から短縮表記にします。
    • 言語 数字の形はユーザーのブラウザーの言語に従います(日本語 1.2万、英語 12K)。固定するには関数を渡します:format: (v) => v.toLocaleString('ja-JP')
    • CompositeChart シリーズごとに format を指定でき、そのシリーズが載る軸も同じ形式になります。

    凡例 · ツールチップ · キーボード

    • 凡例 — シリーズが複数あるチャート(と円グラフ)に自動で付きます。項目をクリックするとそのシリーズの表示・非表示が切り替わり、軸が合わせ直されます。表示中の最後のひとつは隠せません。凡例は legend: false で消せ、hidden: [1] でその項目を隠した状態から始まります。クリックで別のことをしたい場合は凡例のイベントを見てください。
    • ツールチップ — マウス・タッチ・ペンで動きます。タップすると、他の場所をタップするまで開いたままです。ツールチップはチャートの外にはみ出しません。tooltip: false で消せます。中身の自作やリンク・ボタンについてはツールチップの中身を自作するとツールチップのリンクとボタンを見てください。
    • キーボード — チャートにフォーカスし、← → ↑ ↓ で移動、Home · End で端へ移動、Enter で onClick、Esc で閉じます。Tab でツールチップのリンクやボタンに入ります。読んだ値はスクリーンリーダーに読み上げられます。
    • クリック — onClick(hit, chart) は項目をクリックしたときだけ呼ばれます。hit には index、label、value、series(シリーズの番号)、row(渡した項目そのもの)があり、階層チャートでは path(最上位からの名前)が加わります。ズームやブラシのドラッグを終えるクリックは、項目のクリックとはみなしません。
    js
    new BarChart(el, {
      data: rows,
      title: '月別売上',                 // スクリーンリーダーが読み上げる名前
      onClick: (hit) => openDetail(hit.row),
    });

    状態 · アニメーション

    js
    chart.setState('loading', '読み込み中…');
    chart.setState('error', 'ネットワークエラー');
    chart.setState('empty');   // emptyText(既定は 'No data')
    chart.setState(null);      // 閉じる

    データが空なら emptyText が自動で表示され、データが届くと消えます。アニメーションはチャートが画面に入ったときに始まり、animate: false で無効にできます。「視差効果を減らす」を有効にしているユーザーには常に無効です。

    共通オプション

    すべてのオプションに既定値があるので、必要なものだけを渡してください。チャートの種類ごとのオプションはチャート別オプションにあります。

    オプション型既定値説明
    dataチャートによる—データの形を参照
    titlestringチャートの種類名スクリーンリーダーが読み上げる名前。Gauge では値の下に表示
    colorsstring[]CSS 変数か PALETTEこのチャートの色(Heatmap と Waterfall はオブジェクト)
    formatIntl options | (v) => stringブラウザーの言語ツールチップと値軸の数値書式
    labelFormat(label) => string—x 軸のラベルとツールチップのタイトル(軸のあるチャート)
    min · maxnumberデータから値軸の範囲(軸のあるチャート、Gauge、Realtime)
    legendbooleanシリーズが複数なら表示false で非表示
    hiddennumber[][]隠す凡例項目の位置。凡例のクリックで更新される(凡例のあるチャート)— 凡例のイベント
    tooltipboolean | { render?, actions? }truefalse で無効。render: 中身、actions: リンクとボタン — 中身の自作 · リンクとボタン
    animatebooleantrue最初の描画と変更をアニメーションする
    emptyTextstring'No data'データがないときの文字
    onClick(hit, chart) => void—項目がクリックされたか Enter が押された
    onHover(hit | null, chart) => void—ポインターの下の項目が変わった。離れると null — サイドパネル
    onLegend(index, visible, chart, event) => void—凡例項目がクリックされた(切り替わる前)。event.preventDefault() でそのまま保つ
    annotations{ x | y, label?, color?, axis? }[]—基準線・目標線・帯(値軸のあるチャート)— 基準線
    zoomboolean | 'brush'falseズームとパン、またはブラシ(Line、MultiLine、Area、Composite、Candlestick、Scatter)— ズーム
    range[from, to] | null全体表示する x の範囲(上記のチャート。zoom の有無は問わない)
    onZoom(range, chart) => void—ユーザーが範囲を変えた
    syncstring—同じ名前のチャートとクロスヘア・範囲を共有 — 同期

    メソッド

    メソッド戻り値説明
    update(options)thisオプション(データを含む)をマージし、アニメーションで描き直す
    setState(state, text?)this'loading' · 'empty' · 'error' を表示。null で閉じる
    render()thisCSS 変数を読み直し、最終フレームを今すぐ描く(画面外、印刷、書き出し)
    destroy()—リスナーとオブザーバーを外し、要素を元に戻す
    push(v | v[]) · clear()thisRealtimeChart のみ: サンプルをひとつ追加(シリーズが複数なら配列)· すべて削除

    パッケージはほかに Chart(継承して独自のチャートを作る)と既定の色 PALETTE を公開しています。それ以外はありません。

    チャート別オプション

    チャートオプション
    項目ごとに値ひとつのチャートlabel、value: 行を読む関数 ((row) => row.sales)
    BardataLabels: true または (value, row, index) => string。行の low · high で誤差棒を描く
    Linecurve: 'smooth' · 'linear' · 'step', xScale: 'category' · 'time', yScale: 'linear' · 'log', fill、points。行の low · high で帯を描く
    MultiLinecurve, xScale
    Areastacked: true · false · 'percent'
    StackedBarstacked: true(既定) · 'percent'
    Bubbleradius: [min, max] px(既定 [4, 32])
    PieinnerRadius: 半径に対する割合 0〜0.9(0.6 = ドーナツ)、center: 中央の文字か false
    Polarscale: 'sqrt' · 'linear'
    Radarmax(外側のリングの値)
    Gaugemin (0), max (100), unit
    Heatmapcolors: { low, high }
    Waterfallcolors: { up, down, total }
    Funnel · Treemap · SunburstlabelColor(#fff)。Sunburst: center(中央の文字)か false
    Sparklinefill, lastDot, min, max
    Realtimewindow (200), min, max
    Compositeシリーズごとに type: 'bar' · 'line' · 'area' · 'scatter', axis: 値軸の名前(既定は 'left')、format、low · high。チャートには xScale、 stacked: true · 'percent'
    CandlestickxScale, colors: { up, down } (#10b981 · #ef4444)
    Networkradius: [min, max] px(既定 [4, 16])
    Mapgeo: GeoJSON, projection: 'mercator' · 'equirectangular', scale: 'linear' · 'log', colors: { low, high }, labelFormat: 地域名

    TypeScript の型が含まれているので、入力中にエディターが各チャートのオプションとデータの形を表示します。

    1.x から 2.0 へ

    2.0 では、ひとつのことをする方法はひとつだけです。1.x の名前を使うとコンソールが新しい名前を教えてくれるので、ページを開いて警告に従ってください。1.x のままにするなら npm install @aeriz/chart@1 でインストールします。

    js
    // 1.x
    new MultiLineChart(el, { categories, series, interpolation: 'linear', yTickFormat: (v) => v + '%' });
    chart.setData(rows);
    chart.setLoading('…');
    gauge.setValue(80);
    
    // 2.0
    new MultiLineChart(el, { data: { categories, series }, curve: 'linear', format: (v) => v + '%' });
    chart.update({ data: rows });
    chart.setState('loading', '…');
    gauge.update({ data: 80 });
    1.x2.0
    setData(d)update({ data: d })
    setLoading · setEmpty · setError · clearStatesetState('loading' | 'empty' | 'error' | null, text?)
    invalidate()render()
    Gauge setValue(v) · value · labelupdate({ data: v }) · data · title
    categories · series · layers · axes (options)data: { categories, series }
    Heatmap xLabels · yLabels · data: [{ x, y, value }]data: { x, y, values: [[…]] }
    Realtime series · windowSize · yMin · yMax · waitingTextdata: { series } · window · min · max · emptyText
    ariaLabeltitle
    palette · colorcolors
    colorLow/High · colorUp/Down/Totalcolors: { low, high } · colors: { up, down, total }
    yTickFormat · xTickFormatformat · labelFormat
    yLeftTickFormat · yRightTickFormat各シリーズの format
    interpolation ('step-after' …)curve: 'smooth' · 'linear' · 'step'
    yMin · yMaxmin · max (軸のあるすべてのチャート)
    minRadius · maxRadiusradius: [min, max]
    centerLabel: false · totalLabelcenter: false · center: 'text'
    Pie innerRadius: 80 (px) · 'auto'innerRadius: 0.6 (比率のみ)
    Waterfall isTotaltotal
    Scatter r · Bubble zsize
    Composite の点 values: [{ x, y }]values: [value | null](他のシリーズと同じ)
    [['Jan', 64], …] のペア{ Jan: 64 } か [{ label, value }]
    SparklineSparklineChart
    onClick(hit, point, chart) (null でも呼ばれる)onClick(hit, chart)(項目のときだけ)。 hit.data → hit.row
    React · Vue <AerizChart type={BarChart} options={…} /><BarChart data={…} {…options} /> (/react · /vue から)
    Svelte use:aeriz={{ type: BarChart, … }} · onReadyuse:barChart={{ … }} · chartOf(node)
    jQuery install($) · .aerizChart(PieChart, …) · 'setData'install($, { PieChart }) · .aerizChart('pie', …) · 'update'
    getFPS · getActiveCount · scheduler · Engine · drawCartesian · toRows · math公開しない(内部用)