売上ダッシュボード
KPI カード、複合チャート、ドーナツ、ヒートマップ、ファネルまで 8 つのチャート。どれもオプションはいくつかだけで、月別 · 四半期別の切り替えは update() 1 回です。
26 種類のキャンバスチャートを、オプションオブジェクトひとつで描くライブラリです。使い方はひとつだけで、React · Vue · Svelte · jQuery でも名前とオプションは同じです。
@aeriz/chart は、26 種類の Canvas チャートをひとつのオプションオブジェクトで描きます。コンテナとデータを渡すだけで、軸・凡例・ツールチップ・アニメーション・テーマは既定値が引き受けます。
data、変更は update()、状態は setState()。26 種類・5 つの環境すべてで同じです。2.1.1 の新機能 ツールチップのリンク・ボタンと独自の内容、凡例クリックの差し替え、ポインター下の項目の取得。2.1 のコードはそのまま動きます。
2.1 の新機能 基準線・区間、ズーム・ブラシ、同期、100% 積み上げ、誤差棒、複数の値軸、そしてローソク足・ツリーマップ・サンバースト・サンキー・ネットワーク・地図。2.0 のコードはそのまま動きます。
実際のプロダクト画面のように作ったサンプルです。すべてこのページ上で動いていて、JS・HTML・CSS タブにあるのがその画面のコードのすべてです。どのチャートも new SomeChart(element, { data }) にオプションをいくつか足すだけです。チャートの種類ごとの見た目はチャートの種類にあります。
KPI カード、複合チャート、ドーナツ、ヒートマップ、ファネルまで 8 つのチャート。どれもオプションはいくつかだけで、月別 · 四半期別の切り替えは update() 1 回です。
右軸付きの 4 層複合チャート、積み上げ面、ARR ブリッジ、コホート継続率、四分位分布、20,000 点、8,760 マスのヒートマップまで 9 つのチャート。セグメントのボタンひとつで全部が update() されます。
新規登録(棒)と 8 週平均(面)は左軸、転換率(線)は右の % 軸です。赤い点は平均から大きく外れた週です。
凡例をクリックするとチャネルが外れ、残りが積み直されます。
期首 ARR から新規・拡大・縮小・解約を経て期末まで。
まだ来ていない月は空のまま(null)です。
8,000 セッションから計算した四分位と外れ値。
アンケート 6 項目、10 点満点。
プランごとに色分け。マウスを乗せると 1 人を選び出します。
散布図と同じデータから数えています。
週末と通勤時間帯が目立ちます。どのマスにもツールチップがあります。
左の地域の棒をクリックすると、onClick が他のチャートをその地域に切り替え、1 秒単位の取引 1,000,000 件を作り直して描きます。かかった時間は上部にそのまま表示されます。
0.1 秒ごとに値が流れるリアルタイムの線、ゲージ 3 つ、API ごとの応答時間。「障害を再現」を押してみてください。
同じチャートを白い紙の上に置くと、文字色と背景を読んで明るいテーマになります。ブランドカラーは CSS 変数 2 行です。
総合満足度は 5 点満点中 4.3 点で、昨年より 0.4 点上がりました。すべての年代でスコアが上がり、配送の速さがいちばん大きく効いています。
お使いのパッケージマネージャーを選んでください。ビルドなしで使う場合は CDN タブを見てください。
npm install @aeriz/chartpnpm add @aeriz/chartyarn add @aeriz/chart<!-- すべて(グローバル変数 Aeriz、gzip で約 38 KB) -->
<script src="https://cdn.jsdelivr.net/npm/@aeriz/chart@2.1.1/dist/aeriz.min.js"></script>
<!-- チャートひとつ(ES モジュール) -->
<script type="module">
import { BarChart } from 'https://cdn.jsdelivr.net/npm/@aeriz/chart@2.1.1/dist/esm/charts/bar.js';
</script>npm パッケージには、minify 済みのビルド(dist/)と TypeScript の型だけが入っています。
import → チャートごとに分かれた dist/esm/require → dist/aeriz.min.cjsdist/aeriz.min.jsminify で短くするのはローカル変数名だけです。オプション名、メソッド、チャート名、エラーメッセージはそのまま読めます。
ヒント CDN の URL には @2.1.1 のように正確なバージョンを書きましょう。URL が変わらないので、1 年間キャッシュされます。
必要なのは、高さのある要素とデータだけです。高さがない場合は 320px になります。
<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 つのどれでも受け取ります。意味はすべて同じです。
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 を足します(誤差棒)。
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 回だけ伝えます。
[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 のアダプターからでも同じです。
import { BarChart, PieChart } from '@aeriz/chart'; // この 2 つと共通コアだけバンドラーを使わない場合や、確実にひとつのチャートだけを読み込みたい場合は、サブパスから import します。
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
5 つの環境はすべて同じチャート名とオプションを使います。フレームワークなしなら、クラスをそのまま使います。
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(); // 要素がページから外れるとき@aeriz/chart/react からチャート名と同じコンポーネントを import します。オプションはすべて props です。React 16.8 以降で動作します。
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 }}
/>
);
}update() を呼びます。毎回のレンダーで作り直されるインラインのオブジェクトや関数は、値が同じなら描き直しません。[...rows, row])。className、style、id、aria-*、data-* はラッパーの <div> に付きます。StrictMode でもチャートはひとつだけ作られます。@aeriz/chart/vue からチャート名と同じコンポーネントを import します。オプションは props で、onClick・onHover・onLegend・onZoom はイベント @click・@hover・@legend・@zoom になります。Vue 3.2 以降で動作します。
<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())は検知されません。
@aeriz/chart/svelte にはチャートごとのアクション(barChart、lineChart、multiLineChart …)があり、パラメーターがオプションです。コンパイラーの設定は不要で、Svelte 3・4・5 で同じです。
<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) を使います。
使うチャートを install($, { … }) で登録し、サブパス名('bar'、'pie' …)で作成します。CDN のスクリプト(aeriz.min.js)は、先に jQuery を読み込んでおけば 26 種類すべてを自動で登録します。
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 });<script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/@aeriz/chart@2.1.1/dist/aeriz.min.js"></script>
<script>
$('#share').aerizChart('pie', { data: { Chrome: 64, Safari: 19 } });
</script>$('#share').aerizChart('update', { data: { Chrome: 70, Safari: 20 } }); // setState · render · destroy も同じ書き方
$('#share').aerizChart('instance'); // チャートのインスタンス実際に動いています。凡例をクリックすると、シリーズを非表示・表示に切り替えられます。
| クラス | サブパス | data | 特徴 |
|---|---|---|---|
BarChart | bar | 項目ごとに値ひとつ | 負の値は下へ伸びる、dataLabels |
HBarChart | hbar | 項目ごとに値ひとつ | 横向き、ラベル欄はラベルに合わせた幅 |
LineChart | line | 項目ごとに値ひとつ | curve、時間軸、対数軸、100 万点、ズーム、区間 |
AreaChart | area | categories · series | stacked('percent')、ズーム |
StackedBarChart | stacked-bar | categories · series | 負の値は下へ積み上げ、stacked: 'percent' |
GroupedBarChart | grouped-bar | categories · series | シリーズを横に並べる、誤差棒 |
MultiLineChart | multi-line | categories · series | ポインターに追従する共通ツールチップ、ズーム、区間 |
ScatterChart | scatter | [{ x, y }] | 色とサイズごとにまとめて描画、ズーム |
BubbleChart | bubble | [{ x, y, size }] | size は面積 |
PieChart | pie | 項目ごとに値ひとつ | innerRadius でドーナツ、凡例から扇形を切り替え |
RadarChart | radar | categories · series | 点ごとのツールチップ |
PolarChart | polar | 項目ごとに値ひとつ | 面積が値に比例(半径にするなら scale: 'linear') |
GaugeChart | gauge | 数値 | update({ data }) は表示中の値から動く |
HeatmapChart | heatmap | { x, y, values } | colors: { low, high } |
BoxplotChart | boxplot | [{ min, q1, median, q3, max }] | 外れ値の点 |
FunnelChart | funnel | 項目ごとに値ひとつ | 最初の段階からの転換率 |
TreemapChart | treemap | 項目ごとに値ひとつ(+ children) | 正方形に近い配置。グループには見出しが付く |
SparklineChart | sparkline | 項目ごとに値ひとつ | 軸のない小さなトレンド線 |
RealtimeChart | realtime | { series } + push() | 固定幅の窓の中を流れる |
WaterfallChart | waterfall | [{ label, value, total? }] | 累計 |
CompositeChart | composite | categories · series(type) | 棒・線・面・点の組み合わせ、複数の値軸、積み上げ棒、ズーム |
CandlestickChart | candlestick | [{ label, open, high, low, close }] | 価格に合わせた軸、ズーム、数万本のローソク足 |
SunburstChart | sunburst | 項目ごとに値ひとつ(+ children) | 階層ごとにリング 1 本、中央に割合 |
SankeyChart | sankey | { links, nodes? } | 値に比例した太さの流れの帯 |
NetworkChart | network | { nodes, links } | 力学レイアウト、隣接ノードのハイライト |
MapChart | map | 項目ごとに値ひとつ + geo | GeoJSON の地域を色分け、scale: 'log' |
期間ごとの始値・高値・安値・終値を描きます。実体は始値から終値まで(上がったときは colors.up、下がったときは colors.down)、ひげは安値から高値までです。値軸は 0 からではなく、表示中の価格に合わせます。
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 を持つ行はグループになり、グループの値は子の合計です。深さに制限はありません。
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 });{ JS: 42, TS: 30 })は 2.0 とまったく同じに描かれます。Engineering › Backend: $42M)が出て、onClick でも同じパスを hit.path として受け取れます。段階間の流れを、値に比例した太さの帯で描きます。ノードはリンクから作られ、始点からの最長経路の分だけ右の列に置かれます。出ていく流れのないノードは最後の列に並びます。
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() を使うと、落ち着いた配置をすぐに描きます。
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 で探します。
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 でツールチップの地域名を変えられます。properties には英語名(name)、韓国語名(ko)、1 人あたり GDP(gdp)が入っています。南極は除いています。RealtimeChart に push() した値は右端に現れ、window を超えた値は左端から消えます。
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 軸(ラベル・時間・数値)に置かれます。
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' }, // 縦の基準線
],
});y のみ)で使えます。それ以外のチャートではコンソールにその旨が表示されます。label は横線なら右端の上(線が最上部にあるときは下)、縦線なら上端に置かれます。color は線・帯・文字に使われます(既定は薄い文字色)。x が値、y が項目ラベルです。CompositeChart では axis で線を置く値軸を選びます(値軸を増やす)。update({ annotations }) はアニメーションなしで線だけを描き直します。zoom: true にすると x 軸を拡大・移動できます。LineChart、MultiLineChart、AreaChart、CompositeChart、CandlestickChart、ScatterChart で使えます。拡大中は値軸が表示中のデータに合わせます(棒や面のある軸は 0 から始まります)。
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 グループのチャートで拡大表示されます。選択範囲の端をドラッグすると大きさが変わり、内側をドラッグすると移動します。
new LineChart('#detail', { data, xScale: 'time', sync: 'traffic' });
new LineChart('#overview', { data, xScale: 'time', sync: 'traffic', zoom: 'brush', range: [from, to] });sync の名前が同じチャートは、クロスヘアとズーム範囲を共有します。同じ x の値(ラベル・時間・数値)で合わせるので、チャートの種類やデータの長さが違っても構いません。
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 つも追従します。
range を持って加わるとそれがグループに渡されます。update({ sync: null }) でグループから抜けます。onZoom はユーザーが操作したチャートでだけ呼ばれるので、グループごとに一度処理すれば十分です。stacked: 'percent' は項目ごとの合計を 100% として割合を積み上げます。値軸は 0〜100% になり、ツールチップには元の値と並べて割合が出ます。
new StackedBarChart(el, { data, stacked: 'percent' }); // 既定は true(値をそのまま)
new AreaChart(el, { data, stacked: 'percent' }); // true · false · 'percent'
new CompositeChart(el, { data, stacked: true }); // 同じ軸の棒('percent' も可)100% 積み上げは正の値の割合なので、負の値は 0 として扱い、コンソールにその旨が出ます。StackedBarChart は常に積み上げるため、stacked には true(既定)と 'percent' だけを指定できます。
行に low と high を加えると、棒には誤差棒、線には帯が付きます。シリーズのデータには値と同じ数の low・high 配列を渡します。値軸は区間全体が見えるように広がり、ツールチップは value (low – high) の形で表示します。
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 は行で、GroupedBarChart・MultiLineChart・CompositeChart はシリーズで受け取ります(Composite は棒と点に誤差棒、線と面に帯を描きます)。それ以外のチャートでは、使わずに無視したことがコンソールに表示されます。
CompositeChart のシリーズに axis の名前を付けると、名前ごとに値軸ができます。'left'(既定)は左側、それ以外の名前は出てきた順に右側に並び、同じ名前のシリーズは軸を共有します。stacked は同じ軸の棒を積み上げます。
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 は左の軸に適用され、他の軸はデータに合わせます。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 にあります。名前はどのフレームワークでも同じです。
new BarChart(el, { data: rows, onClick: open, onHover: show, tooltip: { actions } });<BarChart data={rows} onClick={open} onHover={setHovered} tooltip={{ actions }} /><BarChart :data="rows" :tooltip="{ actions }" @click="open" @hover="(hit) => (hovered = hit)" /><div use:barChart={{ data: rows, onClick: open, onHover: (hit) => (hovered = hit), tooltip: { actions } }}></div>$('#sales').aerizChart('bar', { data: rows, onClick: open, onHover: show, tooltip: { actions } });React で毎回のレンダーごとに新しい関数や tooltip オブジェクトを渡しても、チャートは描き直されません。
tooltip.actions が返すリストはツールチップの下部に並びます。href があればリンク、onClick だけならボタンです。クリックすると先に onClick(hit, chart, event) が実行され、そのあとツールチップが閉じます。ポップアップやサイドパネル、別ページはこの関数から開きます。
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 を使うよう案内します。リンクやボタンのあるツールチップは、マウスがたどり着くまで待ちます。設定は不要で、リンクやボタンのないツールチップはこれまでどおりすぐマウスに追従します。
tooltip.render(hit, chart) が返したものがツールチップになります。項目ごとに 1 回だけ呼ばれ、マウスが同じ項目の上にいる間は呼ばれません。actions も指定すると、リンクとボタンはその下に並びます。
| 戻り値 | ツールチップ |
|---|---|
| 文字列か数値 | そのテキスト(HTML として解釈されることはない) |
| DOM ノード | そのノードをそのまま表示。中にリンクやボタンがあれば、マウスを待つツールチップになる |
null | この項目ではツールチップを出さない |
undefined | 通常のツールチップ |
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}` }],
},
});棒を指すと店舗カードが表示されます。
<template> を複製し、データは textContent で入れるのが手軽です。HTML 文字列はそのままテキストとして表示され、コンソールがノードを返すよう案内します。--aeriz-tooltip-bg · --aeriz-tooltip-fg)に従います。onClick から update({ data }) を呼べば、それがドリルダウンです。新しいデータはアニメーションで入れ替わり、キーボードでは Enter で同じことができます。
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 が更新されるので、保存しておけば次回も同じ状態で開けます。
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 で閉じます。
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 を加えれば、ポインターの下の項目を自作の凡例でも光らせられます。
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 で呼ばれます。マウス・タッチ・キーボード(← →)で同じように動きます。ツールチップの代わりにサイドパネルに詳細を出したり、表の同じ行をハイライトしたり、他のビューと揃えたりするのに使います。
new CompositeChart('#revenue', {
data: { categories: months, series: [thisYear, lastYear] },
tooltip: false, // ツールチップの代わりにサイドパネル
onHover: (hit) => (hit ? showMonth(hit.index) : showYear()),
});チャートの上でマウスを動かしてみてください。離れるとパネルは年間合計に戻ります。
hit には index と label しかありません。値は index を使ってデータから読みます。sync でつながったチャートでは、ユーザーが指しているチャートだけが onHover を呼びます。追従するクロスヘアでは呼ばれません。設定しなくても、チャートは要素の文字色・フォント・背景を読み取り、そこからグリッドや軸の色を作ります。そのため明るいページにも暗いページにもそのままなじみ、OS のダークモードが切り替わるとテーマを読み直します。変えたいものだけを 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-radius | 2 · 3 · 3 |
--aeriz-tooltip-bg · --aeriz-tooltip-fg | 暗い背景 · 白い文字 |
--aeriz-surface | transparent(キャンバスの背景) |
--aeriz-color-1 … 12 | PALETTE の 8 色 |
format は値(ツールチップと値軸)、labelFormat はラベル(x 軸のラベルとツールチップのタイトル)の書式です。軸ごとの書式オプションはありません。
{ 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' } // 時間軸のラベル1.2万、英語 12K)。固定するには関数を渡します:format: (v) => v.toLocaleString('ja-JP')format を指定でき、そのシリーズが載る軸も同じ形式になります。legend: false で消せ、hidden: [1] でその項目を隠した状態から始まります。クリックで別のことをしたい場合は凡例のイベントを見てください。tooltip: false で消せます。中身の自作やリンク・ボタンについてはツールチップの中身を自作するとツールチップのリンクとボタンを見てください。onClick、Esc で閉じます。Tab でツールチップのリンクやボタンに入ります。読んだ値はスクリーンリーダーに読み上げられます。onClick(hit, chart) は項目をクリックしたときだけ呼ばれます。hit には index、label、value、series(シリーズの番号)、row(渡した項目そのもの)があり、階層チャートでは path(最上位からの名前)が加わります。ズームやブラシのドラッグを終えるクリックは、項目のクリックとはみなしません。new BarChart(el, {
data: rows,
title: '月別売上', // スクリーンリーダーが読み上げる名前
onClick: (hit) => openDetail(hit.row),
});chart.setState('loading', '読み込み中…');
chart.setState('error', 'ネットワークエラー');
chart.setState('empty'); // emptyText(既定は 'No data')
chart.setState(null); // 閉じるデータが空なら emptyText が自動で表示され、データが届くと消えます。アニメーションはチャートが画面に入ったときに始まり、animate: false で無効にできます。「視差効果を減らす」を有効にしているユーザーには常に無効です。
すべてのオプションに既定値があるので、必要なものだけを渡してください。チャートの種類ごとのオプションはチャート別オプションにあります。
| オプション | 型 | 既定値 | 説明 |
|---|---|---|---|
data | チャートによる | — | データの形を参照 |
title | string | チャートの種類名 | スクリーンリーダーが読み上げる名前。Gauge では値の下に表示 |
colors | string[] | CSS 変数か PALETTE | このチャートの色(Heatmap と Waterfall はオブジェクト) |
format | Intl options | (v) => string | ブラウザーの言語 | ツールチップと値軸の数値書式 |
labelFormat | (label) => string | — | x 軸のラベルとツールチップのタイトル(軸のあるチャート) |
min · max | number | データから | 値軸の範囲(軸のあるチャート、Gauge、Realtime) |
legend | boolean | シリーズが複数なら表示 | false で非表示 |
hidden | number[] | [] | 隠す凡例項目の位置。凡例のクリックで更新される(凡例のあるチャート)— 凡例のイベント |
tooltip | boolean | { render?, actions? } | true | false で無効。render: 中身、actions: リンクとボタン — 中身の自作 · リンクとボタン |
animate | boolean | true | 最初の描画と変更をアニメーションする |
emptyText | string | '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? }[] | — | 基準線・目標線・帯(値軸のあるチャート)— 基準線 |
zoom | boolean | 'brush' | false | ズームとパン、またはブラシ(Line、MultiLine、Area、Composite、Candlestick、Scatter)— ズーム |
range | [from, to] | null | 全体 | 表示する x の範囲(上記のチャート。zoom の有無は問わない) |
onZoom | (range, chart) => void | — | ユーザーが範囲を変えた |
sync | string | — | 同じ名前のチャートとクロスヘア・範囲を共有 — 同期 |
| メソッド | 戻り値 | 説明 |
|---|---|---|
update(options) | this | オプション(データを含む)をマージし、アニメーションで描き直す |
setState(state, text?) | this | 'loading' · 'empty' · 'error' を表示。null で閉じる |
render() | this | CSS 変数を読み直し、最終フレームを今すぐ描く(画面外、印刷、書き出し) |
destroy() | — | リスナーとオブザーバーを外し、要素を元に戻す |
push(v | v[]) · clear() | this | RealtimeChart のみ: サンプルをひとつ追加(シリーズが複数なら配列)· すべて削除 |
パッケージはほかに Chart(継承して独自のチャートを作る)と既定の色 PALETTE を公開しています。それ以外はありません。
| チャート | オプション |
|---|---|
| 項目ごとに値ひとつのチャート | label、value: 行を読む関数 ((row) => row.sales) |
| Bar | dataLabels: true または (value, row, index) => string。行の low · high で誤差棒を描く |
| Line | curve: 'smooth' · 'linear' · 'step', xScale: 'category' · 'time', yScale: 'linear' · 'log', fill、points。行の low · high で帯を描く |
| MultiLine | curve, xScale |
| Area | stacked: true · false · 'percent' |
| StackedBar | stacked: true(既定) · 'percent' |
| Bubble | radius: [min, max] px(既定 [4, 32]) |
| Pie | innerRadius: 半径に対する割合 0〜0.9(0.6 = ドーナツ)、center: 中央の文字か false |
| Polar | scale: 'sqrt' · 'linear' |
| Radar | max(外側のリングの値) |
| Gauge | min (0), max (100), unit |
| Heatmap | colors: { low, high } |
| Waterfall | colors: { up, down, total } |
| Funnel · Treemap · Sunburst | labelColor(#fff)。Sunburst: center(中央の文字)か false |
| Sparkline | fill, lastDot, min, max |
| Realtime | window (200), min, max |
| Composite | シリーズごとに type: 'bar' · 'line' · 'area' · 'scatter', axis: 値軸の名前(既定は 'left')、format、low · high。チャートには xScale、 stacked: true · 'percent' |
| Candlestick | xScale, colors: { up, down } (#10b981 · #ef4444) |
| Network | radius: [min, max] px(既定 [4, 16]) |
| Map | geo: GeoJSON, projection: 'mercator' · 'equirectangular', scale: 'linear' · 'log', colors: { low, high }, labelFormat: 地域名 |
TypeScript の型が含まれているので、入力中にエディターが各チャートのオプションとデータの形を表示します。
2.0 では、ひとつのことをする方法はひとつだけです。1.x の名前を使うとコンソールが新しい名前を教えてくれるので、ページを開いて警告に従ってください。1.x のままにするなら npm install @aeriz/chart@1 でインストールします。
// 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.x | 2.0 |
|---|---|
setData(d) | update({ data: d }) |
setLoading · setEmpty · setError · clearState | setState('loading' | 'empty' | 'error' | null, text?) |
invalidate() | render() |
Gauge setValue(v) · value · label | update({ 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 · waitingText | data: { series } · window · min · max · emptyText |
ariaLabel | title |
palette · color | colors |
colorLow/High · colorUp/Down/Total | colors: { low, high } · colors: { up, down, total } |
yTickFormat · xTickFormat | format · labelFormat |
yLeftTickFormat · yRightTickFormat | 各シリーズの format |
interpolation ('step-after' …) | curve: 'smooth' · 'linear' · 'step' |
yMin · yMax | min · max (軸のあるすべてのチャート) |
minRadius · maxRadius | radius: [min, max] |
centerLabel: false · totalLabel | center: false · center: 'text' |
Pie innerRadius: 80 (px) · 'auto' | innerRadius: 0.6 (比率のみ) |
Waterfall isTotal | total |
Scatter r · Bubble z | size |
Composite の点 values: [{ x, y }] | values: [value | null](他のシリーズと同じ) |
[['Jan', 64], …] のペア | { Jan: 64 } か [{ label, value }] |
Sparkline | SparklineChart |
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, … }} · onReady | use:barChart={{ … }} · chartOf(node) |
jQuery install($) · .aerizChart(PieChart, …) · 'setData' | install($, { PieChart }) · .aerizChart('pie', …) · 'update' |
getFPS · getActiveCount · scheduler · Engine · drawCartesian · toRows · math | 公開しない(内部用) |