はじめに
セットアップと最初のチャート
ECharts は明示的な width/height を持つ DOM 要素上で初期化します。setOption がチャート全体を設定します。Apache ECharts(旧 Baidu ECharts)は最も強力な JS チャートライブラリの一つです。
<!-- include ECharts -->
<script src="https://cdn.jsdelivr.net/npm/echarts@5/dist/echarts.min.js"></script>
<div id="chart" style="width: 600px; height: 400px;"></div>
<script>
const chart = echarts.init(document.getElementById('chart'));
chart.setOption({
title: { text: 'Sales' },
xAxis: { data: ['Q1', 'Q2', 'Q3', 'Q4'] },
yAxis: {},
series: [{
type: 'bar',
data: [100, 200, 150, 300]
}]
});
</script>テーマとレンダラー付きの初期化
init は (dom, theme, opts) を取ります。'svg' レンダラーはどのズームでもくっきりしていて、シンプルなチャートでは DOM が小さくなります。一方 'canvas' は大きなデータセットで高速です。devicePixelRatio が retina 上の鮮明さを制御しま す。チャートを取り除くときはメモリ解放のため必ず dispose() を呼びましょう。
// register a theme (defined elsewhere or imported)
echarts.registerTheme('myTheme', {
color: ['#5470c6', '#91cc75'],
backgroundColor: '#f5f5f5'
});
// renderer: 'canvas' (default, faster) or 'svg' (sharper, lighter)
const chart = echarts.init(document.getElementById('chart'), 'myTheme', {
renderer: 'svg',
devicePixelRatio: 2,
width: 800,
height: 600,
locale: 'EN'
});
// detached from DOM later
chart.dispose();レスポンシブなリサイズ
ECharts はコンテナが変わっても自動リサイズしません — chart.resize() を呼ぶ必要があります。ResizeObserver がコンテナサイズを監視するモダンな方法です(レイアウト駆動の変更には window resize より優れています)。SPA でのリークを防ぐため、後始末では必ず dispose() を呼びましょう。
const chart = echarts.init(document.getElementById('chart'));
chart.setOption({ /* ... */ });
// resize when window changes
window.addEventListener('resize', () => chart.resize());
// or observe the container
const ro = new ResizeObserver(() => chart.resize());
ro.observe(document.getElementById('chart'));
// resize with explicit size
chart.resize({ width: 500, height: 300, silent: false });
// cleanup
window.addEventListener('unload', () => chart.dispose());setOption のマージモード
デフォルトでは setOption は新しいオプションを既存のものへ深くマージするため、個々の部分を更新できます。notMerge: true はオプション全体を置き換えます(series 数が変わるとき有用)。replaceMerge は特定のコンポーネントタイプ(series、xAxis)を部分置換します。lazyUpdate は複数の setOption 呼び出しを 1 回の描画にまとめます。
const chart = echarts.init(document.getElementById('chart'));
// merge (default): deep-merges with existing option
chart.setOption({ xAxis: { data: ['A', 'B'] } });
// notMerge: replace entire option (old config discarded)
chart.setOption({ xAxis: { data: ['X', 'Y'] } }, { notMerge: true });
// replaceMerge: replace specific component types only
chart.setOption(
{ series: [{ type: 'bar', data: [5, 6] }] },
{ replaceMerge: ['series'] }
);
// lazyUpdate: batch updates, apply on next frame
chart.setOption({ series: [{ data: [1, 2] }] }, { lazyUpdate: true });ライフサイクル:getInstanceByDom と dispose
既にチャートがある DOM で init を呼ぶと例外が投げられます。確認には getInstanceByDom を使いましょう。dispose() がメモリを解放してチャートを取り除きます。DOM 要素は残ります。属性 _echarts_instance_ がチャートのコンテナを印付けるため、迷子のチャートの検索と後始末に使えます。フレームワークのアンマウントフックで必ず dispose しましょう。
function mountChart(dom) {
// avoid double-init on the same DOM node
const existing = echarts.getInstanceByDom(dom);
if (existing) return existing;
const chart = echarts.init(dom);
chart.setOption({ /* ... */ });
return chart;
}
// in a framework cleanup (React useEffect / Vue onUnmounted):
function unmount(dom) {
const chart = echarts.getInstanceByDom(dom);
if (chart) chart.dispose(); // free memory + remove DOM
}
// dispose all charts on a page
echarts.disposeAll?.(); // not built-in; iterate manually
Array.from(document.querySelectorAll('[_echarts_instance_]'))
.forEach(dom => echarts.dispose(dom));棒グラフ
基本の棒グラフ
棒グラフには category の xAxis と value の yAxis が必要です。各 series.data の値が 1 カテゴリに対応します。itemStyle がバーの見た目を制御します。縦棒なら category 軸は x で、横棒なら x と y の軸タイプを入れ替えます。
chart.setOption({
xAxis: {
type: 'category',
data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri']
},
yAxis: { type: 'value' },
series: [{
type: 'bar',
data: [120, 200, 150, 80, 70],
itemStyle: { color: '#5470c6' }
}]
});グループ化と積み上げの棒
同じ xAxis を持つ複数の bar 系列はデフォルトでグループ化されます。積み上げには、各 series に同じ stack 名を付けます。積み上げではカテゴリごとに値が累積します。一緒に積むべき全 series に stack: 'total' を付け — stack 名 のない系列は依然グループ化されます。
chart.setOption({
xAxis: { type: 'category', data: ['Q1', 'Q2', 'Q3', 'Q4'] },
yAxis: { type: 'value' },
// GROUPED: multiple series render side by side
series: [
{ type: 'bar', name: 'A', data: [10, 20, 30, 40] },
{ type: 'bar', name: 'B', data: [15, 25, 35, 45] }
]
});
// STACKED: add stack with same name to each series
chart.setOption({
series: [
{ type: 'bar', name: 'A', stack: 'total', data: [10, 20, 30, 40] },
{ type: 'bar', name: 'B', stack: 'total', data: [15, 25, 35, 45] }
]
});横棒グラフ
横棒は、category 軸を yAxis に、value 軸を xAxis に置いた棒グラフです。position: 'right' のラベルがバーの端に置かれます。横棒は長いカテゴリ名や多くのカテゴリの比較に向いています — 回転したラベルを避けられます。
chart.setOption({
// swap: category axis becomes yAxis
yAxis: {
type: 'category',
data: ['Apple', 'Banana', 'Cherry', 'Date']
},
xAxis: { type: 'value' },
series: [{
type: 'bar',
data: [120, 200, 150, 80],
label: {
show: true,
position: 'right' // label at end of bar
}
}]
});背景と角丸付きの棒
showBackground が各バーの後ろにトラックを描きます(プログレスバー風)。itemStyle.borderRadius がバーの角を丸めます — 縦棒では [topLeft, topRight, bottomRight, bottomLeft]、横棒では逆順です。borderRadius は数値(全角)か配列にできます。
chart.setOption({
xAxis: { type: 'category', data: ['A', 'B', 'C', 'D'] },
yAxis: { type: 'value' },
series: [{
type: 'bar',
data: [50, 80, 60, 90],
showBackground: true,
backgroundStyle: {
color: 'rgba(180, 180, 180, 0.2)',
borderRadius: [4, 4, 0, 0]
},
itemStyle: {
borderRadius: [8, 8, 0, 0] // round top corners
}
}]
});バーレース(動的)
バーレースは順序入れ替えをアニメーションさせます。データ配列をソートし、yAxis のカテゴリと series データの両方を更新しましょう。animationDurationUpdate が遷移の滑らかさを制御します。yAxis.inverse: true で最大値が上に来ます。アニメーションするデータストーリーで人気の手法です。
const data = [
{ name: 'A', value: 10 },
{ name: 'B', value: 20 }
];
chart.setOption({
xAxis: { type: 'value', max: 100 },
yAxis: { type: 'category', inverse: true },
series: [{
type: 'bar',
data: data.map(d => ({ value: d.value, name: d.name })),
label: { show: true, position: 'right' },
// sort bars by value on each update
animationDuration: 500,
animationDurationUpdate: 500
}]
});
// update data on interval
setInterval(() => {
data.forEach(d => d.value += Math.random() * 10);
data.sort((a, b) => b.value - a.value);
chart.setOption({
yAxis: { data: data.map(d => d.name) },
series: [{ data: data.map(d => d.value) }]
});
}, 1000);バーの幅と間隔
barWidth はピクセルかカテゴリ帯のパーセンテージを受け付けます。barGap はグループ内のバーの間隔です(複数 series のときのみ意味があります)。barCategoryGap はグループ間の間隔です。パーセンテージはカテゴリ帯が基準のため、リサイズしても比率が保たれます。
chart.setOption({
xAxis: { type: 'category', data: ['A', 'B', 'C', 'D'] },
yAxis: { type: 'value' },
series: [{
type: 'bar',
data: [50, 80, 60, 90],
barWidth: '40%', // width of each bar
barGap: '20%', // gap between bars in same group
barCategoryGap: '40%', // gap between category groups
// fixed pixel width also works:
// barWidth: 30
}]
});折れ線グラフ
基本の折れ線
折れ線グラフは type: 'line' を使います。ポイントはデフォルトでシンボルマーカー付きで表示されます。隠すには symbol: 'none' を。線はデータ順にポイントを結びます。時系列には、[timestamp, value] ペアと type: 'time' の xAxis を使います。
chart.setOption({
xAxis: { type: 'category', data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri'] },
yAxis: { type: 'value' },
series: [{
type: 'line',
data: [120, 200, 150, 80, 70],
symbol: 'circle', // point marker
symbolSize: 8
}]
});滑らかな線とエリア
smooth: true が線を曲げます(Catmull-Rom 補間)。areaStyle が線の下の領域を塗り、グラデーション(線形のカラーストップ)で色褪せた見た目にできます。category 軸の boundaryGap: false で、隙間を残さず y 軸の縁から線が始まります。
chart.setOption({
xAxis: { type: 'category', boundaryGap: false, data: ['Mon','Tue','Wed','Thu','Fri'] },
yAxis: { type: 'value' },
series: [{
type: 'line',
data: [120, 200, 150, 80, 70],
smooth: true, // curved line
areaStyle: { // fill under line
color: {
type: 'linear',
x: 0, y: 0, x2: 0, y2: 1,
colorStops: [
{ offset: 0, color: 'rgba(84,112,198,0.5)' },
{ offset: 1, color: 'rgba(84,112,198,0.05)' }
]
}
}
}]
});複数系列の折れ線
複数の系列は色で区別された別々の線として描画されます。凡例が表示をトグルします。lineStyle.type は 'solid'、'dashed'、'dotted' を受け付けます。各系列は独自のスタイルを持てます。凡例の name は series.name と一致させる必要があります。
chart.setOption({
legend: { data: ['Email', 'Search'] },
xAxis: { type: 'category', data: ['Mon','Tue','Wed','Thu','Fri'] },
yAxis: { type: 'value' },
series: [
{
type: 'line',
name: 'Email',
data: [120, 132, 101, 134, 90],
lineStyle: { width: 3, type: 'solid' }
},
{
type: 'line',
name: 'Search',
data: [220, 182, 191, 234, 290],
lineStyle: { width: 2, type: 'dashed' }
}
]
});積み上げエリア
積み上げエリアチャートは、同じ stack 名と areaStyle を持つ type: 'line' です。各系列が前の系列の上に積み上がります。emphasis.focus: 'series' がホバーで系列全体をハイライトします。時間経過に伴う構成(ソース別トラフィックなど)の表示に有用です。
chart.setOption({
xAxis: { type: 'category', boundaryGap: false, data: ['Mon','Tue','Wed','Thu','Fri'] },
yAxis: { type: 'value' },
series: [
{
type: 'line',
name: 'A',
stack: 'total',
areaStyle: {},
data: [120, 132, 101, 134, 90],
emphasis: { focus: 'series' }
},
{
type: 'line',
name: 'B',
stack: 'total',
areaStyle: {},
data: [220, 182, 191, 234, 290]
}
]
});ステップ折れ線
step が線を階段に変えます。'start' はポイントの前、'middle'(対称)はポイントで、'end' は後で段差を作ります。ステップチャートは、連続的ではなく離散的に変わる値(在庫水準、サーバー状態)に最適です。
chart.setOption({
xAxis: { type: 'category', data: ['Mon','Tue','Wed','Thu','Fri'] },
yAxis: { type: 'value' },
series: [{
type: 'line',
data: [120, 200, 150, 80, 70],
step: 'middle', // 'start' | 'middle' | 'end'
symbol: 'none',
lineStyle: { width: 2 }
}]
});時間軸付きの折れ線
type: 'time' では、軸が日付を自動整形し不規則な間隔を扱います。データポイントは [timestamp, value] ペアです。ECharts は実際の時間でポイントを配置するため、データの欠落が正しく表示されます。間隔が一定でない時系列には正しい選択です。
chart.setOption({
xAxis: { type: 'time' }, // auto-parses timestamps
yAxis: { type: 'value' },
series: [{
type: 'line',
data: [
[new Date('2024-01-01').getTime(), 100],
[new Date('2024-01-02').getTime(), 200],
[new Date('2024-01-05').getTime(), 150],
[new Date('2024-01-10').getTime(), 300]
],
smooth: true
}]
});円グラフ
基本の円グラフ
円グラフは軸を使いません — series.data は {value, name} の配列です。radius がコンテナの小さい方の寸法に対するパーセンテージで円のサイズを制御します。emphasis のスタイルはホバーで適用されます。凡例は data.name からラベルを自動導出します。
chart.setOption({
series: [{
type: 'pie',
radius: '60%', // radius of pie
data: [
{ value: 1048, name: 'Search' },
{ value: 735, name: 'Direct' },
{ value: 580, name: 'Email' },
{ value: 484, name: 'Union' },
{ value: 300, name: 'Video' }
],
emphasis: {
itemStyle: {
shadowBlur: 10,
shadowOffsetX: 0,
shadowColor: 'rgba(0,0,0,0.5)'
}
}
}]
});ドーナツ(リング)円グラフ
radius を [inner, outer] にするとドーナツになります。中央ラベルは定番パターンです(合計や KPI を表示)。avoidLabelOverlap: false でラベルがその場に留まります。内側の半径がリングの太さを制御します — [50%, 70%] は細いリング、[0%, 70%] は完全な円です。
chart.setOption({
series: [{
type: 'pie',
radius: ['40%', '70%'], // [inner, outer] = ring
avoidLabelOverlap: false,
label: {
show: true,
position: 'center', // center label
formatter: 'Total\n{c}'
},
data: [
{ value: 1048, name: 'A' },
{ value: 735, name: 'B' },
{ value: 580, name: 'C' }
]
}]
});ローズ(ナイチンゲール)チャート
roseType でスライスの半径が値に比例します(ナイチンゲールのバラ)。'area' は半径に sqrt(value) を使い(面積比例)、'radius' は値をそのまま使います。各スライスは同じ角度で異なる半径を持ちます。角度だけでは判断しにくい大きさの比較に向いています。
chart.setOption({
series: [{
type: 'pie',
radius: ['10%', '70%'],
roseType: 'area', // or 'radius'
data: [
{ value: 40, name: 'A' },
{ value: 38, name: 'B' },
{ value: 32, name: 'C' },
{ value: 30, name: 'D' },
{ value: 28, name: 'E' }
],
label: { show: true }
}]
});カスタムラベル付きの円グラフ
label.formatter はテンプレート変数をサポートします:{a}(系列名)、{b}(データ名)、{c}(値)、{d}(パーセンテージ)。labelLine が接続線を制御します。length がスライス側のセグメント、length2 がラベル側のセグメントです。カスタムラベルで円グラフの読みやすさが大きく向上します。
chart.setOption({
series: [{
type: 'pie',
radius: '60%',
label: {
formatter: '{b}: {d}%', // name: percentage
color: '#333',
fontSize: 14
},
labelLine: {
show: true,
length: 15, // first segment
length2: 20, // second segment
smooth: true
},
data: [
{ value: 1048, name: 'Search' },
{ value: 735, name: 'Direct' }
]
}]
});半円の円グラフ
startAngle と endAngle の組み合わせで部分的な円(半分、4 分の 1、ゲージ風)が作れます。center が円の位置を決めます — ['50%','70%'] で下に押し下げ、180 度の円が下部に置かれます。部分的な円はゲージや様式化されたダッシュボードによく使われます。
chart.setOption({
series: [{
type: 'pie',
radius: ['40%', '70%'],
center: ['50%', '70%'], // move down
startAngle: 180, // start at left
endAngle: 360, // end at right -> semicircle
data: [
{ value: 60, name: 'A' },
{ value: 30, name: 'B' },
{ value: 10, name: 'C' }
]
}]
});散布図
基本の散布図
散布図は 2 つの value 軸を使い、各データポイントは [x, y] です。symbolSize がポイントのサイズを制御します(固定か、関数でポイントごと)。散布図は 2 変数間の相関を明らかにします。category ベースの棒/折れ線と違い、両軸は type: 'value'(数値)です。
chart.setOption({
xAxis: { type: 'value' },
yAxis: { type: 'value' },
series: [{
type: 'scatter',
symbolSize: 12,
data: [
[10, 20], [15, 25], [20, 30], [25, 35],
[30, 40], [35, 45], [40, 50], [45, 55]
],
itemStyle: { color: '#5470c6' }
}]
});バブルチャート(値によるサイズ)
バブルチャートは、ポイントサイズが第 3 の次元を符号化する散布図です。ポイントごとに [x, y, size] を渡し、symbolSize をサイズを返す関数にします。関数はポイントごとに動くため、各バブルが独立にスケールします。3D チャートなしで 3 変数のデータに有用です。
chart.setOption({
xAxis: { type: 'value' },
yAxis: { type: 'value' },
series: [{
type: 'scatter',
// each point: [x, y, size]
data: [
[10, 20, 30],
[15, 25, 60],
[20, 30, 12],
[25, 35, 45]
],
symbolSize: function (data) {
return data[2]; // use 3rd element as size
}
}]
});VisualMap 付き散布図(値による色)
visualMap が データの次元を色へマッピングします。dimension: 2 で各ポイントの第 3 要素(インデックス 2)で色分けします。inRange.color がグラデーションを定義します。散布図に第 4 の次元(色)を加えられます。visualMap コンポーネントがスライダー付きの凡例を表示します。
chart.setOption({
xAxis: { type: 'value' },
yAxis: { type: 'value' },
visualMap: {
min: 0,
max: 100,
dimension: 2, // map color to 3rd element
inRange: { color: ['#50a3ba', '#eac736', '#d94e5d'] },
right: 10,
top: 'center'
},
series: [{
type: 'scatter',
data: [[10,20,30], [15,25,60], [20,30,12]],
symbolSize: 15
}]
});エフェクト散布図(アニメーション)
effectScatter は各ポイントの周りにさざ波のアニメーションを加えます — 重要なデータポイント(アラート、上位の都市)のハイライトに最適です。showEffectOn がさざ波を再生するタイミングを制御します。brushType: 'stroke' は軽量で、'fill' はより目立ちます。さざ波が多すぎると気を散らすため、控えめに使いましょう。
chart.setOption({
xAxis: { type: 'value' },
yAxis: { type: 'value' },
series: [{
type: 'effectScatter', // animated ripple
symbolSize: function (data) { return data[2]; },
data: [[10, 20, 30], [15, 25, 60]],
showEffectOn: 'render', // 'render' or 'emphasis'
rippleEffect: {
brushType: 'stroke', // 'stroke' or 'fill'
period: 4,
scale: 3
}
}]
});大規模散布図
数千のポイントではプログレッシブレンダリングを有効化しましょう — ECharts がデータをチャンクに分割し、フレームをまたいで描画してフリーズを避けます。large: true は最適化された単一の描画呼び出しを使います。overplotting への対処には小さな symbolSize と opacity を組み合わせましょう。これで 5 万ポイント以上も滑らかになります。
// for thousands of points, use progressive rendering
chart.setOption({
xAxis: { type: 'value' },
yAxis: { type: 'value' },
series: [{
type: 'scatter',
data: largeDataArray, // 50k+ points
symbolSize: 3,
progressive: 2000, // chunk size for progressive render
progressiveThreshold: 5000, // enable above this count
large: true, // optimize for many points
largeThreshold: 2000,
itemStyle: { opacity: 0.6 }
}]
});レーダーチャート
基本のレーダー
レーダーチャートには各軸(name と max)を定義する radar.indicator 配列が必要です。series のデータは indicator に対応する値の配列です。レーダーは少数のアイテムの複数属性を比較するのに最適です(プレイヤーのステータス、製品比較)。max が各軸のスケールを設定します。
chart.setOption({
radar: {
indicator: [
{ name: 'Speed', max: 100 },
{ name: 'Power', max: 100 },
{ name: 'Range', max: 100 },
{ name: 'Comfort', max: 100 },
{ name: 'Price', max: 100 }
]
},
series: [{
type: 'radar',
data: [{ value: [85, 70, 90, 65, 80], name: 'Car A' }]
}]
});複数系列のレーダー
複数のデータエントリは重なり合う多角形として描画され、比較に最適です。各エントリには凡例と一致する一意の name が必要です。系列が多すぎると(5 以上)、多角形が塊に重なって読めなくなります。明快さのため 2〜4 アイテムに留めましょう。
chart.setOption({
legend: { data: ['Car A', 'Car B'] },
radar: {
indicator: [
{ name: 'Speed', max: 100 },
{ name: 'Power', max: 100 },
{ name: 'Range', max: 100 }
]
},
series: [{
type: 'radar',
data: [
{ value: [85, 70, 90], name: 'Car A' },
{ value: [60, 95, 75], name: 'Car B' }
]
}]
});エリア付きのレーダー
areaStyle がレーダーの多角形を半透明の色で塗り、形状が読みやすくなります。lineStyle が輪郭を強調します。重なる系列が見えるよう、areaStyle の opacity は低く(0.2〜0.4)保ちましょう。シンボルが各頂点を示します。
chart.setOption({
radar: {
indicator: [
{ name: 'A', max: 100 },
{ name: 'B', max: 100 },
{ name: 'C', max: 100 }
]
},
series: [{
type: 'radar',
data: [{ value: [85, 70, 90], name: 'Score' }],
areaStyle: { opacity: 0.3 },
lineStyle: { width: 2 },
symbol: 'circle',
symbolSize: 6
}]
});レーダーの形状と軸
shape: 'polygon'(デフォルト)は角ばった軸を、'circle' は滑らかなリングを作ります。splitNumber がグリッドの密度を制御し、splitArea がゼブラ効果の色を交互に付けます。axisName が軸のラベルを整形します。これらのオプションはデータに触れずにチャートの視覚構造を制御します。
chart.setOption({
radar: {
shape: 'polygon', // 'polygon' or 'circle'
radius: '65%',
splitNumber: 5, // grid ring count
axisName: {
color: '#333',
fontSize: 12
},
splitLine: { lineStyle: { color: '#ccc' } },
splitArea: {
areaStyle: { color: ['#fafafa', '#fff'] }
},
indicator: [
{ name: 'Speed', max: 100 },
{ name: 'Power', max: 100 }
]
},
series: [{ type: 'radar', data: [{ value: [80, 70] }] }]
});レーダーの極半径
radius: [inner, outer] でリング状のレーダー(ドーナツ風)が作れます。center がチャートの位置を決めます。indicator の min が軸の始点を設定します — すべての値が高いとき(中心の小さな多角形を避ける)に有用です。軸ラベルのための場所を残すよう center を調整しましょう。
chart.setOption({
radar: {
indicator: [
{ name: 'A', max: 100, min: 0 }, // min sets the inner bound
{ name: 'B', max: 100 },
{ name: 'C', max: 100 }
],
radius: ['20%', '70%'], // [inner, outer] for ring radar
center: ['50%', '55%']
},
series: [{
type: 'radar',
data: [{ value: [60, 70, 80] }]
}]
});ヒートマップ
直交座標のヒートマップ
直交座標のヒートマップにはセルを色分けする visualMap が必要です。データは [x, y, value] です。label: { show: true } がセルに値を印刷します( 小さなグリッドだけに向く)。calculable: true でスライダーのハンドルが加わります。ヒートマップは密度パターン(時間帯別の活動など)を明らかにします。
const hours = ['12a','1a','2a','3a','4a','5a','6a','7a','8a','9a','10a','11a'];
const days = ['Sat','Sun','Mon','Tue','Wed','Thu','Fri'];
// data: [x, y, value]
const data = [[0,0,5],[0,1,1],[1,0,8] /* ... */];
chart.setOption({
tooltip: {},
xAxis: { type: 'category', data: hours },
yAxis: { type: 'category', data: days },
visualMap: {
min: 0, max: 10,
calculable: true,
orient: 'horizontal',
left: 'center', bottom: '5%'
},
series: [{
type: 'heatmap',
data: data,
label: { show: true }
}]
});カレンダーヒートマップ
カレンダーヒートマップは 1 年分の日次値を示します(GitHub 風のコントリビューショングラフ)。calendar.range が年か日付範囲を設定します。データポイントは [dateString, value] です。visualMap のグラデーションがカラーストップを定義します。cellSize が正方形のサイズを制御します — 'auto' でコンテナに合わせます。
const data = [];
// generate one year of data
for (let i = 0; i < 365; i++) {
const date = new Date(2024, 0, 1);
date.setDate(date.getDate() + i);
data.push([date.toISOString().slice(0,10), Math.floor(Math.random() * 100)]);
}
chart.setOption({
tooltip: {},
visualMap: {
min: 0, max: 100,
inRange: { color: ['#ebedf0', '#c6e48b', '#7bc96f', '#239a3b', '#196127'] }
},
calendar: {
range: '2024',
cellSize: ['auto', 13],
yearLabel: { show: true }
},
series: [{ type: 'heatmap', data: data }]
});ヒートマップのアイテムスタイル
itemStyle.borderColor と borderWidth がグリッド区切り効果を作ります(白い罫線でセルがくっきり分かれます)。borderRadius がセルの角を丸めます。emphasis のスタイルはホバーで適用されます。隠された visualMap(show: false)は、凡例を表示せずに色を駆動し続けます。
chart.setOption({
xAxis: { type: 'category', data: ['A','B','C','D'] },
yAxis: { type: 'category', data: ['X','Y','Z'] },
visualMap: { min: 0, max: 100, show: false },
series: [{
type: 'heatmap',
data: [[0,0,80],[0,1,30],[1,0,50]],
itemStyle: {
borderColor: '#fff', // white grid lines
borderWidth: 2,
borderRadius: 4
},
emphasis: {
itemStyle: { shadowBlur: 10 }
}
}]
});パンチカードヒートマップ
パンチカードは曜日と時間別の活動を示す 7x24 のヒートマップです。各セルが 1 つの時間帯です。角丸の itemStyle でドットのように見えます。パンチカードは週間のパターン(サーバーが最も混む時間帯など)を明らかにします。データは完全な 168 セルのグリッドです。
const data = [];
for (let day = 0; day < 7; day++) {
for (let hour = 0; hour < 24; hour++) {
data.push([hour, day, Math.floor(Math.random() * 50) + 1]);
}
}
chart.setOption({
xAxis: { type: 'category', data: Array.from({length:24}, (_,i) => i + 'h') },
yAxis: { type: 'category', data: ['Sun','Mon','Tue','Wed','Thu','Fri','Sat'] },
visualMap: { max: 50, inRange: { color: ['#fff', '#5470c6'] } },
series: [{
type: 'heatmap',
data: data,
itemStyle: { borderRadius: 10, borderWidth: 2, borderColor: '#fff' }
}]
});地図上のヒートマップ
geo と map 系列を組み合わせると、値で領域が色分けされます。visualMap がカラースケールを駆動します。まず echarts.registerMap('china', geoJson) で地図を登録する必要があります。roam: true でパン/ズームが可能になります。コロプレス(地域別着色)地図はこのように作られます。
// requires a registered geo map (e.g. echarts.registerMap)
chart.setOption({
geo: { map: 'china', roam: true },
visualMap: {
min: 0, max: 1000,
inRange: { color: ['#e0ecf4', '#005824'] }
},
series: [{
type: 'map',
map: 'china',
data: [
{ name: 'Beijing', value: 800 },
{ name: 'Shanghai', value: 950 }
]
}]
});ツリーチャート
基本のツリー(縦向き)
ツリーチャートは階層データを描画します。layout: 'orthogonal' と orient: 'LR' で左から右のツリーになります。expandAndCollapse でクリックによるサブツリーの折りたたみ/展開が可能になります。leaves が葉ノードのスタイルを設定します。ツリーは組織図、ファイルツリー、分類に最適です。
const data = {
name: 'Root',
children: [
{
name: 'Child A',
children: [{ name: 'A1' }, { name: 'A2' }]
},
{
name: 'Child B',
children: [{ name: 'B1' }]
}
]
};
chart.setOption({
series: [{
type: 'tree',
data: [data],
top: '5%', left: '10%', bottom: '5%', right: '20%',
layout: 'orthogonal', // 'orthogonal' or 'radial'
orient: 'LR', // 'LR','RL','TB','BT'
symbolSize: 10,
label: { position: 'left' },
leaves: { label: { position: 'right' } },
expandAndCollapse: true,
animationDuration: 550
}]
});横向きツリー
orient: 'LR' で横向きのツリーになります(根が左、葉が右)。内部ノードのラベルはノードの「左」に、葉のラベルは「右」に置かれます — 分岐と重ならないためです。lineStyle の curveness で、柔らかい見た目の曲線コネクタが作れます。
chart.setOption({
series: [{
type: 'tree',
data: [treeData],
layout: 'orthogonal',
orient: 'LR', // left to right
symbol: 'emptyCircle',
symbolSize: 7,
label: { position: 'left', verticalAlign: 'middle', align: 'right' },
leaves: { label: { position: 'right', align: 'left' } },
lineStyle: { color: '#999', width: 1, curveness: 0.5 }
}]
});ラジアルツリー
layout: 'radial' は根を中心に置き、子を円形に外へ放射します。横向きレイアウトでは広すぎる大きなツリーに適しています。emphasis.focus: 'descendant' がホバーで全子孫をハイライトし、分岐の追跡を助けます。
chart.setOption({
series: [{
type: 'tree',
data: [treeData],
layout: 'radial', // circular layout
symbol: 'circle',
symbolSize: 8,
label: {
position: 'inside',
rotate: 0
},
leaves: { label: { position: 'right' } },
emphasis: { focus: 'descendant' },
lineStyle: { curveness: 0.5 }
}]
});カスタムシンボル付きツリー
symbol と symbolSize はノードごとのカスタマイズのための関数を受け付けます。ここでは、子を持つ内部ノードが大きい長方形、葉が小さい円になっています。これで階層レベルが視覚的に区別されます。クラシックな上から下の組織図には orient: 'TB' と組み合わせましょう。
const treeData = {
name: 'CEO',
value: 'Boss',
children: [
{ name: 'VP Engineering', children: [{ name: 'Eng Lead' }] },
{ name: 'VP Sales', children: [{ name: 'Sales Lead' }] }
]
};
chart.setOption({
series: [{
type: 'tree',
data: [treeData],
symbol: function (params) {
// custom symbol per node
return params.data.children ? 'rect' : 'circle';
},
symbolSize: function (params) {
return params.data.children ? 15 : 8;
},
orient: 'TB',
label: { position: 'top', distance: 8 }
}]
});ツリーの展開/折りたたみ制御
initialTreeDepth が初期状態で開くレベル数を制御します(null = すべて、0 = 根だけ)。子を持つノードのクリックでサブツリーがトグルします。クリックイベントでノード選択に反応できます — ドリルダウン UI に有用です。animationDurationUpdate が展開/折りたたみを滑らかにします。
chart.setOption({
series: [{
type: 'tree',
data: [treeData],
expandAndCollapse: true,
initialTreeDepth: 2, // expand first 2 levels
collapse: 'collapseBtn',
symbol: 'circle',
animationDurationUpdate: 750
}]
});
// programmatic control via API
chart.on('click', function (params) {
if (params.componentType === 'series') {
console.log('Node clicked:', params.data.name);
console.log('Collapsed:', params.data.collapsed);
}
});サンバーストチャート
基本のサンバースト
サンバーストは放射状のツリーで、各リングが 1 階層を表します。内側 = 親、外側 = 子です。各ノードの値が角度上の大きさを駆動します。radius: [0, '90%'] で完全な円盤、[inner, outer] でリング状のサンバーストになります。階層的な比率の可視化に最適です。
const data = [{
name: 'Root',
children: [
{
name: 'A',
value: 15,
children: [{ name: 'A1', value: 5 }, { name: 'A2', value: 10 }]
},
{
name: 'B',
value: 20,
children: [{ name: 'B1', value: 20 }]
}
]
}];
chart.setOption({
series: [{
type: 'sunburst',
data: data,
radius: [0, '90%'],
label: { rotate: 'radial' }
}]
});レベル付きサンバースト
levels が各リングを個別に設定します — 最初のエントリが根で、以降のエントリが深いレベルに対応します。そのレベルの内側/外側半径は r0/r です。ラベルの回転(radial、tangential、0)をレベルごとに変えると、各深さでテキストが読めます。きめ細かいスタイル制御が可能になります。
chart.setOption({
series: [{
type: 'sunburst',
data: sunburstData,
radius: ['15%', '90%'],
levels: [
{}, // root level (default)
{
r0: '15%',
r: '45%',
label: { rotate: 0, fontSize: 14 },
itemStyle: { borderWidth: 2 }
},
{
r0: '45%',
r: '70%',
label: { rotate: 'tangential', fontSize: 12 }
},
{
r0: '70%',
r: '90%',
label: { rotate: 'radial', fontSize: 10 }
}
]
}]
});サンバーストのスタイルとハイライト
emphasis.focus: 'ancestor' がホバーしたノードから根までの経路をハイライトします — ユーザーはスライスが階層のどこにあるか分かります。borderWidth がスライスを視覚的に分離します。サンバーストはインタラクティブです:クリックで通常ドリルダウンします。深いツリーで文脈を保つため、祖先のハイライトを使いましょう。
chart.setOption({
series: [{
type: 'sunburst',
data: data,
itemStyle: {
borderColor: '#fff',
borderWidth: 1
},
emphasis: {
focus: 'ancestor' // highlight ancestors on hover
},
highlight: {
itemStyle: { color: '#ffb' }
}
}]
});値とソート付きサンバースト
sort が親内のスライスの順序を制御します。nodeClick: 'zoomToNode' でクリックがそのサブツリーへズームします(探索に最適)。minAngle は 5 度未満のスライスのラベルを隠し、雑然さを避けます。親ノードの値は省略した場合、子から自動合算されます。
chart.setOption({
series: [{
type: 'sunburst',
data: [{
name: 'Root',
children: [
{ name: 'A', value: 30, children: [/* ... */] },
{ name: 'B', value: 70, children: [/* ... */] }
]
}],
nodeClick: 'zoomToNode', // click to zoom into subtree
sort: 'desc', // or 'asc', null
label: { minAngle: 5 } // hide labels on tiny slices
}]
});サンバーストのドリルダウン
カスタムクリックハンドラで独自のドリルダウン UX を構築できます。ズームインするには、データをクリックされたノードで置き換えます。「戻る」ボタンが欲しければ親への参照を保持しましょう。サンバーストのドリルダウンは、画面を圧迫せずに深い階層を探索するのに優れています。
const data = [/* full tree */];
let currentRoot = data[0];
chart.setOption({
series: [{
type: 'sunburst',
data: data,
nodeClick: false
}]
});
chart.on('click', function (params) {
if (params.componentType === 'series' && params.data.children) {
// manually drill down
currentRoot = params.data;
chart.setOption({
series: [{ data: [currentRoot] }]
}, { notMerge: true });
}
});サンキーダイアグラム
基本のサンキー
サンキーはノード間の流れを示します。data がノード(名前付き)で、links が流れ(source、target、value)です。各リンクの幅は値に比例します。emphasis.focus: 'adjacency' がホバーで接続ノードをハイライトします。エネルギー、金銭、ユーザーフローの可視化に最適です。
chart.setOption({
series: [{
type: 'sankey',
data: [
{ name: 'Source A' },
{ name: 'Source B' },
{ name: 'Mid C' },
{ name: 'Sink D' }
],
links: [
{ source: 'Source A', target: 'Mid C', value: 5 },
{ source: 'Source B', target: 'Mid C', value: 3 },
{ source: 'Mid C', target: 'Sink D', value: 8 }
],
emphasis: { focus: 'adjacency' },
lineStyle: { color: 'gradient', curveness: 0.5 }
}]
});サンキーのノードレベル
levels が深さ(列)ごとにノードを整形します。lineStyle.color: 'source' はリンクをソースノードの色に合わ せ、'target' はターゲットに合わせ、'gradient' は混ぜます。nodeAlign が列内でノードを垂直に配置します。depth を明示的に設定すると、自動レイアウトを上書きして列の配置が決まります。
chart.setOption({
series: [{
type: 'sankey',
data: [
{ name: 'A', depth: 0 },
{ name: 'B', depth: 1 },
{ name: 'C', depth: 2 }
],
links: [
{ source: 'A', target: 'B', value: 10 },
{ source: 'B', target: 'C', value: 10 }
],
levels: [
{ depth: 0, itemStyle: { color: '#fbb' }, lineStyle: { color: 'source' } },
{ depth: 1, itemStyle: { color: '#bfb' }, lineStyle: { color: 'target' } },
{ depth: 2, itemStyle: { color: '#bbf' } }
],
nodeAlign: 'justify' // 'left','right','justify'
}]
});サンキーのスタイルとギャップ
nodeWidth が各ノードの長方形の太さを設定し、nodeGap が垂直方向の間隔を制御します。間隔を狭めると多くのノードが見えますが重なることがあります。lineStyle.opacity で流れを控えめにし、ノードを目立たせましょう。label.position: 'right' はラベルをノードの横に置きます — 左から右の流れで一般的です。
chart.setOption({
series: [{
type: 'sankey',
data: nodes,
links: links,
nodeWidth: 20, // width of each node rectangle
nodeGap: 10, // vertical gap between nodes
nodeAlign: 'justify',
label: {
fontSize: 12,
color: '#333',
position: 'right'
},
lineStyle: { opacity: 0.4 },
itemStyle: { borderWidth: 0 }
}]
});循環付きサンキー(排水)
本当の循環は ECharts のサンキーを失敗させます。回避策は、再循環するノードを別の「入り」と「出」のノード(例:'Recycle')に分割し、流れを非循環にすることです。これでフィードバックループが視覚的に表現されます。流れの保存を必ず検証しましょう:ノードの入力合計は出力合計と一致すべきです。
// Sankey normally forbids cycles, but you can show feedback loops
// by splitting a node into two (in & out) with the same name suffix
chart.setOption({
series: [{
type: 'sankey',
data: [
{ name: 'Input' },
{ name: 'Process' },
{ name: 'Output' },
{ name: 'Recycle' }
],
links: [
{ source: 'Input', target: 'Process', value: 100 },
{ source: 'Process', target: 'Output', value: 80 },
{ source: 'Process', target: 'Recycle', value: 20 },
{ source: 'Recycle', target: 'Process', value: 20 }
],
emphasis: { focus: 'adjacency' }
}]
});サンキーのインタラクション
サンキーのクリックイベントは dataType でノードとエッジを区別します。これを使って、流れの詳細を示す詳細パネルを構築しましょう。label.formatter: '{b}: {c}' が名前と値を表示します。隣接フォーカスがホバーしたノードを通る経路全体をハイライトし、因果の連鎖を明らかにします。
chart.setOption({
series: [{
type: 'sankey',
data: nodes,
links: links,
emphasis: {
focus: 'adjacency',
lineStyle: { opacity: 0.8 }
},
label: { formatter: '{b}: {c}' },
tooltip: { trigger: 'item' }
}]
});
chart.on('click', function (params) {
if (params.dataType === 'edge') {
console.log('Flow from', params.data.source, 'to', params.data.target);
console.log('Value:', params.data.value);
} else if (params.dataType === 'node') {
console.log('Node:', params.data.name);
}
});ファネルチャート
基本のファネル
ファネルは、各段階でアイテムが減っていくプロセスの段階を示します。sort: 'descending'(デフォルト)が最大の段階を上に置きます。データはプロセスの流れ順に並べましょう。ファネルは営業パイプライン、コンバージョン分析、オンボーディングのステップに最適です。
chart.setOption({
series: [{
type: 'funnel',
data: [
{ value: 100, name: 'Visit' },
{ value: 75, name: 'Sign Up' },
{ value: 50, name: 'Trial' },
{ value: 25, name: 'Purchase' }
],
sort: 'descending' // 'descending','ascending','none'
}]
});ソートとギャップ付きフ ァネル
sort: 'ascending' がファネルを反転させます(上に最小、成長チャートのように)。gap が読みやすさのためスライスを分離します。funnelAlign がスライスを水平に配置します。minSize/maxSize がスライス幅をパーセンテージで束縛し、小さな段階も見えるようにします。
chart.setOption({
series: [{
type: 'funnel',
data: data,
sort: 'ascending', // smallest at top
gap: 4, // pixel gap between slices
funnelAlign: 'center', // 'left','center','right'
width: '60%',
minSize: '20%',
maxSize: '100%'
}]
});ファネルのラベル
position: 'inside' はラベルをスライスの上に重ね、'left'/'right' は接続線(labelLine)付きで外側に置きます。formatter: '{b}: {c}' が名前と値を表示します。スライスが細すぎて内側にテキストが入らないときは外側のラベルを使いましょう。emphasis がホバーでラベルを拡大します。
chart.setOption({
series: [{
type: 'funnel',
data: data,
label: {
show: true,
position: 'inside', // 'inside','left','right'
formatter: '{b}: {c}'
},
labelLine: {
show: true,
length: 20,
lineStyle: { width: 1, type: 'solid' }
},
emphasis: {
label: { fontSize: 16 }
}
}]
});ファネルのアイテムスタイル
スライスごとの itemStyle がデフォルトの色サイクルを上書きします。borderColor がスライスを視覚的に分離します。個々のデータアイテムに color を設定することもできます。洗練された見た目には、順序のあるカラーパレット(初期段階は明るく、コンバージョンは濃く)でファネルの比喩を強化しましょう。
chart.setOption({
series: [{
type: 'funnel',
data: [
{ value: 100, name: 'A', itemStyle: { color: '#5470c6' } },
{ value: 75, name: 'B', itemStyle: { color: '#91cc75' } },
{ value: 50, name: 'C', itemStyle: { color: '#fac858' } }
],
itemStyle: {
borderColor: '#fff',
borderWidth: 2,
borderRadius: 0
}
}]
});比較ファネル
複数の funnel 系列を並べて期間比較が できます。位置は各系列に独自の left/width を与えます。A/B テストの可視化や前年比のコンバージョン比較に最適です。区別のため、系列ごとにコントラストのある色を使いましょう。
chart.setOption({
series: [
{
type: 'funnel',
name: '2023',
data: [{ value: 100, name: 'A' }, { value: 40, name: 'B' }],
sort: 'descending',
left: '5%', width: '40%',
label: { position: 'inside' }
},
{
type: 'funnel',
name: '2024',
data: [{ value: 120, name: 'A' }, { value: 60, name: 'B' }],
sort: 'descending',
left: '55%', width: '40%',
label: { position: 'inside' }
}
]
});ゲージチャート
基本のゲージ
ゲージは弧の上に単一の値を示します。min/max がスケールを設定します。progress が値までの色付きの弧を表示し(軌道は axisLine)、detail が中央に値のテキストを描画します。valueAnimation が数字を滑らかに遷移させます。KPI や単一指標のダッシュボードに最適です。
chart.setOption({
series: [{
type: 'gauge',
min: 0,
max: 100,
progress: { show: true, width: 18 },
axisLine: { lineStyle: { width: 18 } },
detail: {
valueAnimation: true,
formatter: '{value}%'
},
data: [{ value: 70, name: 'Score' }]
}]
});ポインター付きゲージ
pointer スタイルがクラシックなゲージの見た目です。anchor が中央のピンです。distance の負の値で目盛り/ラベルが内側(中心方向)へ押し込まれます。radius がゲージ全体を拡縮します。物理的な計器を模倣するには、pointer を splitLine と組み合わせましょう。アナログな感覚が欲しいときに有用です。
chart.setOption({
series: [{
type: 'gauge',
radius: '60%',
min: 0, max: 100,
pointer: { show: true, length: '60%', width: 5 },
anchor: { show: true, size: 12, itemStyle: { color: '#333' } },
axisTick: { distance: -15, length: 5 },
splitLine: { distance: -20, length: 10 },
axisLabel: { distance: -25 },
data: [{ value: 42 }]
}]
});カラーバン ド付きゲージ
axisLine.lineStyle.color は [しきい値, 色] ペアの配列を受け付け、色のゾーンを作ります(リスクレベルの赤/黄/緑など)。しきい値は分数(0〜1)です。ゲージに「安全/警告/危険」の範囲を示す標準的な方法です。ポインターか progress の弧が、これらのゾーン内の現在値を示します。
chart.setOption({
series: [{
type: 'gauge',
min: 0, max: 100,
axisLine: {
lineStyle: {
width: 20,
color: [
[0.3, '#fd666d'], // 0-30% red
[0.7, '#37a2da'], // 30-70% blue
[1, '#91cc75'] // 70-100% green
]
}
},
data: [{ value: 85 }]
}]
});マルチポインターのゲージ
複数のデータエントリで同じゲージに複数のポインターが作られます。関連する指標の比較に有用です(CPU 対メモリ対ディスク)。各値は独立にアニメーションします。数は低く保ちましょう(最大 3〜5)— 多いとゲージが雑然とします。名前は各ポインターの近くにラベルとして現れます。
chart.setOption({
series: [{
type: 'gauge',
min: 0, max: 100,
data: [
{ value: 60, name: 'CPU' },
{ value: 40, name: 'Memory' },
{ value: 80, name: 'Disk' }
],
detail: { formatter: '{value}%' },
title: { fontSize: 14 }
}]
});カスタムゲージ(円形プログレス)
startAngle/endAngle を 360 度にわたるように設定すると、円形のプログレスリングになります(Apple Watch のリングのように)。pointer/目盛り/ラベルを隠すときれいなミニマリストの見た目になります。roundCap がプログレスの端を丸めます。このスタイルはモダンなダッシュボードで人気です — リングを装ったゲージです。
chart.setOption({
series: [{
type: 'gauge',
startAngle: 90,
endAngle: -270, // full circle
pointer: { show: false },
progress: {
show: true,
overlap: false,
roundCap: true,
clip: false
},
axisLine: { lineStyle: { width: 20, color: [[1, 'rgba(0,0,0,0.1)']] } },
splitLine: { show: false },
axisTick: { show: false },
axisLabel: { show: false },
detail: {
valueAnimation: true,
offsetCenter: ['0%', '0%'],
fontSize: 30,
formatter: '{value}%'
},
data: [{ value: 65 }]
}]
});座標系
複数の X 軸
xAxis は配列です — 各エントリが独立した軸です。series は xAxisIndex(0 起点)で軸に束縛されます。1 つのチャートで、異なるスケールや単位の 2 つの指標を表示できます。position で軸を上/下に置けます。株価チャート(価格 + 出来高)や天気(気温 + 湿度)でよく使われます。
chart.setOption({
xAxis: [
{ type: 'category', data: ['A','B','C'], position: 'bottom' },
{ type: 'category', data: ['A','B','C'], position: 'top', axisLine: { onZero: false } }
],
yAxis: { type: 'value' },
series: [
{ type: 'line', data: [10, 20, 30], xAxisIndex: 0 },
{ type: 'line', data: [50, 60, 70], xAxisIndex: 1 }
]
});双方向 Y 軸
左右の 2 つの y 軸で、異なる単位の系列をプロットできます(例:ドルでの売上対販売数)。各系列は yAxisIndex で軸に束縛します。ユーザーがどの線がどの軸に対して読むべきか分かるよう、右軸の線をその系列に合わせて色分けしましょう。3 軸以上は混乱するため避けます。
chart.setOption({
xAxis: { type: 'category', data: ['Mon','Tue','Wed','Thu'] },
yAxis: [
{ type: 'value', name: 'Sales', position: 'left' },
{ type: 'value', name: 'Orders', position: 'right', axisLine: { lineStyle: { color: '#ee6666' } } }
],
series: [
{ type: 'bar', data: [200, 180, 250, 210], yAxisIndex: 0 },
{ type: 'line', data: [40, 35, 50, 42], yAxisIndex: 1, smooth: true }
]
});極座標
極座標は angleAxis(円の周り)と radiusAxis(中心から外へ)を使います。series は coordinateSystem: 'polar' を設定します。startAngle: 90 で 0 度が上(北)に来ます。極座標は方向性のあるデータ(風配図)、周期的なパターン、ローズ/ナイチンゲールのバリアントに最適です。
chart.setOption({
polar: {},
angleAxis: {
type: 'category',
data: ['N','NE','E','SE','S','SW','W','NW'],
startAngle: 90
},
radiusAxis: { type: 'value' },
series: [{
type: 'bar',
data: [1, 2, 3, 4, 5, 6, 7, 8],
coordinateSystem: 'polar'
}]
});カレンダー座標
カレンダー座標系は日付をセルへマッピングします。coordinateSystem: 'calendar' の系列が束縛します。cellSize はピクセルか 'auto' です。orient: 'horizontal' が標準の週行レイアウトです。dayLabel/monthLabel の nameMap でラベルをローカライズします。コントリビューショングラフには heatmap と組み合わせましょう。
chart.setOption({
calendar: {
range: ['2024-01-01', '2024-12-31'],
cellSize: ['auto', 15],
left: 50, right: 30,
orient: 'horizontal',
dayLabel: { nameMap: 'en' },
monthLabel: { nameMap: 'en' },
yearLabel: { show: false }
},
series: [{
type: 'heatmap',
coordinateSystem: 'calendar',
data: calendarData
}]
});平行座標
平行座標は次元ごとに 1 軸で多次元データをプロットします。各データ行が全軸を横切る折れ線になります。高次元データの相関とクラスタが明らかになります(価格、燃費、年式、安全性で車を比較するなど)。データ探索に有用です。
chart.setOption({
parallelAxis: [
{ dim: 0, name: 'Price' },
{ dim: 1, name: 'Mileage' },
{ dim: 2, name: 'Year' },
{ dim: 3, name: 'Safety', type: 'category', data: ['Low','Med','High'] }
],
parallel: {
parallelAxisDefault: {
axisLine: { lineStyle: { color: '#999' } },
nameTextStyle: { color: '#333' }
}
},
series: [{
type: 'parallel',
data: [[20000, 30, 2020, 'High'], [25000, 25, 2021, 'Med']]
}]
});地図のセットアップ
registerMap が GeoJSON を名前に結び、geo と map 系列で使えるようにします。roam でマウスのパン/ズームが可能になります。itemStyle.areaColor が領域を塗り、borderColor が輪郭を描きます。emphasis のスタイルはホバーで適用されます。geo 単独では地図を示すだけで、値による地域着色(コロプレス)には map 系列と組み合わせましょう。
// load a map GeoJSON (must be registered before use)
fetch('https://geo.datav.aliyun.com/areas_v3/bound/100000_full.json')
.then(r => r.json())
.then(geoJson => {
echarts.registerMap('china', geoJson);
chart.setOption({
geo: {
map: 'china',
roam: true, // pan & zoom
zoom: 1.2,
label: { show: false },
itemStyle: {
areaColor: '#eee',
borderColor: '#fff'
},
emphasis: {
label: { show: true },
itemStyle: { areaColor: '#f5f5f5' }
}
}
});
});Dataset
基本の Dataset
Dataset はデータを series 設定から分離します。source は 2 次元配列です(最初の行がヘッダー)。seriesLayoutBy: 'column' で各系列が 1 列を取ります。encode が dataset の列を x/y へマッピングします。データが表現から切り離されるため、複数チャートでデータを共有するときに有用です。
chart.setOption({
dataset: {
source: [
['product', '2023', '2024'],
['Apple', 41, 56],
['Banana', 67, 28],
['Cherry', 89, 76]
]
},
xAxis: { type: 'category' },
yAxis: {},
series: [
{ type: 'bar', seriesLayoutBy: 'column', encode: { x: 'product', y: '2023' } },
{ type: 'bar', seriesLayoutBy: 'column', encode: { x: 'product', y: '2024' } }
]
});オブジェクト行の Dataset
Dataset の source はオブジェクトの配列(キー・バリュー行)にできます。dimensions で列を宣言でき(行にキーが欠けるとき有用)、encode はインデックスの代わりに次元名を使って読みやすくなります。オブジェクト行は手で書きやすく、自己文書化されています。
chart.setOption({
dataset: {
dimensions: ['product', 'count', 'score'],
source: [
{ product: 'Apple', count: 41, score: 90 },
{ product: 'Banana', count: 67, score: 75 },
{ product: 'Cherry', count: 89, score: 88 }
]
},
xAxis: { type: 'category' },
yAxis: {},
series: [
{ type: 'bar', encode: { x: 'product', y: 'count' } },
{ type: 'bar', encode: { x: 'product', y: 'score' } }
]
});Dataset の変換(filter/sort)
Transform は dataset を連結します:filter が行を除去し、sort が並べ替えます。各 transform は fromDatasetId から読み込み、新しい dataset を公開します。series は datasetId で束縛します。Transform により、データをコピーせずに 1 つのソースからビューを派生させられます。対応する transform:filter、sort、registerTransform 経由のカスタム。
chart.setOption({
dataset: [
{
id: 'raw',
source: [
{ product: 'A', sales: 100 },
{ product: 'B', sales: 50 },
{ product: 'C', sales: 200 }
]
},
{
id: 'filtered',
fromDatasetId: 'raw',
transform: {
type: 'filter',
config: { and: [{ gte: { sales: 80 } }] }
}
},
{
id: 'sorted',
fromDatasetId: 'filtered',
transform: { type: 'sort', config: { order: 'desc', main: 'sales' } }
}
],
xAxis: { type: 'category' },
yAxis: {},
series: [{ type: 'bar', datasetId: 'sorted', encode: { x: 'product', y: 'sales' } }]
});Dataset の Encode と Dimensions
encode が dataset の列(インデックスか名前で)をチャートの次元へマッピングします。encode.tooltip がツールチップに表示する列を列挙します。ここでは、位置に列 0/1、サイズに 2、色に 3(itemStyle 経由)を使っています。Encode により同じ dataset が異なるチャートタイプで再利用できます。
chart.setOption({
dataset: {
source: [
[10, 20, 30, 'red'],
[15, 25, 35, 'blue'],
[20, 30, 40, 'green']
]
},
xAxis: { type: 'value' },
yAxis: { type: 'value' },
series: [{
type: 'scatter',
encode: {
x: 0, // first column -> x
y: 1, // second column -> y
tooltip: [0, 1, 2] // show these in tooltip
},
symbolSize: function (d) { return d[2]; }
}]
});円グラフ付き Dataset
円グラフには encode 経由の itemName と value のマッピングが必要です。同じ dataset が、異なる encode で棒グラフ(encode x:name、y:value)と円グラフの両方を供給できます。これが dataset の強みです:1 つのソース、複数のビュー。チャートタイプの切り替えは series type と encode を変えるだけです。
chart.setOption({
dataset: {
source: [
{ name: 'Search', value: 1048 },
{ name: 'Direct', value: 735 },
{ name: 'Email', value: 580 }
]
},
series: [{
type: 'pie',
radius: '60%',
encode: { itemName: 'name', value: 'value' }
}]
});VisualMap
連続 VisualMap
連続 visualMap は数値範囲を色(と省略可能なサイズ)へマッピングします。inRange.color がグラ デーション(補間)です。calculable: true でフィルタリング用のドラッグハンドルが加わります。orient と left/top が位置を決めます。visualMap が系列の色を駆動するため、itemStyle.color を手動で設定する必要はありません。
chart.setOption({
visualMap: {
type: 'continuous',
min: 0,
max: 100,
inRange: {
color: ['#50a3ba', '#eac736', '#d94e5d'],
symbolSize: [10, 50]
},
calculable: true, // show slider handles
orient: 'vertical',
left: 'left', top: 'bottom'
},
series: [{
type: 'scatter',
data: [[10,20,30], [50,60,80], [80,90,95]]
}]
});区分 VisualMap
区分 visualMap は値を離散的な範囲へ分割し、それぞれに独自の色を与えます。pieces がビン(min/max/label/color)を定義します。カテゴリ的なバケット(低/中/高リスクなど)が欲しいときは、グラデーションより明快です。コロプレス地図やカテゴリ化された散布図に有用です。
chart.setOption({
visualMap: {
type: 'piecewise',
pieces: [
{ min: 0, max: 30, label: 'Low', color: '#91cc75' },
{ min: 30, max: 70, label: 'Mid', color: '#fac858' },
{ min: 70, max: 100, label: 'High', color: '#ee6666' }
],
orient: 'horizontal',
left: 'center', bottom: 10
},
series: [{
type: 'scatter',
data: data
}]
});カテゴリ VisualMap
カテゴリ visualMap は文字列カテゴリを色へマッピングします。categories が値を列挙し、inRange.color が対応する色を順に列挙します。dimension がどのデータ列でマッピングを駆動するか選びます(デフォルト 0)。色分けしたいカテゴリ属性(優先度、ステータスなど)があるときに最適です。
chart.setOption({
visualMap: {
type: 'piecewise',
categories: ['Low', 'Medium', 'High'],
inRange: { color: ['#91cc75', '#fac858', '#ee6666'] },
dimension: 2 // which data column to map
},
series: [{
type: 'scatter',
data: [
[10, 20, 'Low'],
[50, 60, 'Medium'],
[80, 90, 'High']
]
}]
});VisualMap のインラインと範囲外
outOfRange は visualMap の選択範囲の外にあるデータポイントを整形します(フィルタ時にグレー表示など)。controller がスライダー自体を整形します。ユーザーがフィルタのためにスライダーをドラッグすると、範囲外のポイントが outOfRange.color へ薄れます。これで visualMap が単なる凡例ではなくインタラクティブなフィルタになります。
chart.setOption({
visualMap: {
min: 0, max: 100,
inRange: { color: ['#5470c6', '#91cc75'] },
outOfRange: { color: '#ccc', symbolSize: 5 }, // filtered out style
controller: {
inRange: { color: ['#5470c6', '#91cc75'] }
},
right: 10, top: 'center'
},
series: [{
type: 'scatter',
data: data
}]
});複数系列への VisualMap
デフォルトでは visualMap はすべての系列に影響します。特定の系列を対象にするには seriesIndex(数値か配列)を使いましょう。ある系列を色分けしつつ他はそのままにできます — ハイライトした dataset を参照データと比較するとき有用です。1 つのチャートが異なる系列のために複数の visualMap を持つことも可能です。
chart.setOption({
visualMap: {
min: 0, max: 100,
inRange: { color: ['#5470c6', '#91cc75', '#fac858'] }
},
series: [
{ type: 'scatter', name: 'A', data: dataA },
{ type: 'scatter', name: 'B', data: dataB }
]
});
// bind visualMap to specific series only
chart.setOption({
visualMap: { seriesIndex: 1 } // only affects second series
});凡例
基本の凡例
凡例は系列名を一覧し表示をトグルします。data は series.name と一致する必要があります(自動導出も可能)。icon がマーカーを整形します。凡例項目のクリックがその系列をトグルします。setOption で系列が追加/削除されると、凡例は自動更新されます。
chart.setOption({
legend: {
data: ['Email', 'Search', 'Direct'],
show: true,
icon: 'roundRect', // 'circle','rect','roundRect','triangle','diamond','pin','arrow'
itemWidth: 20,
itemHeight: 14,
textStyle: { color: '#333', fontSize: 12 }
},
series: [
{ type: 'line', name: 'Email', data: [120, 200, 150] },
{ type: 'line', name: 'Search', data: [220, 180, 90] }
]
});凡例の位置とレイアウト
orient と top/left が凡例を配置します。よくあるレイアウト:上中央(デフォルト)、下中央、右縦。itemGap が凡例項目の間隔を制御します。控えめな背景/罫線で凡例がチャートから視覚的に分離されます。位置は重要です — 下の凡例は縦のスペースを解放します。
chart.setOption({
legend: {
orient: 'horizontal', // 'horizontal' or 'vertical'
top: 'top', // 'top','bottom','middle' or px
left: 'center', // 'left','center','right' or px
itemGap: 20, // gap between items
padding: 5,
backgroundColor: '#f5f5f5',
borderColor: '#ddd',
borderWidth: 1,
borderRadius: 4
},
series: [/* ... */]
});凡例の選択とデフォルト
selected が初期の表示状態を制御します。selectedMode: 'single' で凡例がラジオボタンのように振る舞います(1 系列だけ表示)。legendselectchanged イベントはユーザーのトグルで発火します — 設定の永続化や複数チャートの同期に有用です。デフォルトモードは 'multiple' です。
chart.setOption({
legend: {
selected: {
'Email': true, // visible by default
'Search': false, // hidden by default
'Direct': true
},
selectedMode: 'multiple' // 'single' or 'multiple'
},
series: [
{ type: 'line', name: 'Email', data: [120, 200, 150] },
{ type: 'line', name: 'Search', data: [220, 180, 90] },
{ type: 'line', name: 'Direct', data: [100, 90, 80] }
]
});
chart.on('legendselectchanged', function (params) {
console.log('Selected:', params.selected);
});スクロール可能な凡例
type: 'scroll' で、項目が多すぎるとき凡例がページ分割されます — ページボタンが現れます。10 系列以上で溢れてしまうチャートには不可欠です。ペ ージのアイコン/テキストスタイルでナビゲーションをカスタマイズできます。縦スクロールの凡例は右の余白にうまく収まります。
chart.setOption({
legend: {
type: 'scroll', // 'plain' (default) or 'scroll'
orient: 'vertical',
right: 10, top: 20, bottom: 20,
pageButtonItemStyle: { color: '#333' },
pageIconColor: '#5470c6',
pageIconInactiveColor: '#ccc',
pageTextStyle: { color: '#333' },
data: Array.from({length: 30}, (_, i) => 'Series ' + i)
},
series: [/* many series */]
});凡例 Formatter とリッチテキスト
formatter が凡例ラベルをカスタマイズします(大文字化、カウントの追加など)。リッチテキストでラベルの一部を異なるスタイルにできます — textStyle.rich でスタイルを定義し、formatter から {style|text} 構文で参照します。これで「A {count|42}」のように混在スタイルの凡例が実現します。
chart.setOption({
legend: {
data: ['A', 'B'],
formatter: function (name) {
return name.toUpperCase();
},
textStyle: {
rich: {
a: { color: '#5470c6', fontSize: 14, fontWeight: 'bold' },
b: { color: '#91cc75', fontSize: 12 }
}
}
},
series: [/* ... */]
});
// legend can also show values via legendselectchanged + setOption
chart.on('legendselectchanged', () => {
// dynamic label updates
});ツールチップ
基本のツールチップ
trigger: 'item' はデータポイントごとにツールチップを示します(scatter、pie)。'axis' はカテゴリ全体に示します(bar、line)。axisPointer がガイド線を描きます — 'shadow' は半透明の帯(棒に良し)、'line' は細い線(折れ線に良し)、'cross' は x と y の両方の線を示します。
chart.setOption({
tooltip: {
trigger: 'axis', // 'item','axis','none'
show: true,
backgroundColor: 'rgba(50,50,50,0.9)',
borderColor: '#333',
borderWidth: 1,
padding: 10,
textStyle: { color: '#fff', fontSize: 13 },
axisPointer: { type: 'shadow' } // 'line','shadow','cross'
},
xAxis: { type: 'category', data: ['A','B','C'] },
yAxis: { type: 'value' },
series: [{ type: 'bar', data: [10, 20, 30] }]
});ツールチップの Formatter
formatter がツールチップの内容をカスタマイズします。関数は params(name、value、seriesName、color など)を受け取り HTML を返します。文字列テンプレートは {a}(系列名)、{b}(カテゴリ/x)、{c}(値)、{d}(円のパーセンテージ)を使います。複数系列の軸ツールチップでは、params が配列なので反復しましょう。
chart.setOption({
tooltip: {
trigger: 'item',
formatter: function (params) {
// params has: name, value, seriesName, color, dataIndex, ...
return '<b>' + params.name + '</b><br/>' +
'Value: ' + params.value + '<br/>' +
'Series: ' + params.seriesName;
}
},
series: [{ type: 'pie', data: [/* ... */] }]
});
// string template form (for axis trigger)
chart.setOption({
tooltip: {
trigger: 'axis',
formatter: '{a}: {b} = {c}' // a=series, b=category, c=value
}
});ツールチップの十字線と Axis Pointer
トップレベルの axisPointer.link が複数チャート(マルチチャートダッシュボード)でポインターを同期します — xAxisIndex: 'all' を渡します。type: 'cross' は x と y の値をラベルに示す完全な十字線を表示します。crossStyle/lineStyle がガイド線をカスタマイズします。積み重ねたチャート間でデータを比較するには、同期されたポインターが不可欠です。
chart.setOption({
tooltip: { trigger: 'axis' },
xAxis: { type: 'category', data: ['Mon','Tue','Wed','Thu'] },
yAxis: { type: 'value' },
axisPointer: {
link: [{ xAxisIndex: 'all' }], // sync pointers across charts
label: { backgroundColor: '#333' }
},
series: [{ type: 'line', data: [10, 20, 30, 40] }]
});
// per-axis pointer type
chart.setOption({
tooltip: {
axisPointer: {
type: 'cross',
crossStyle: { color: '#999' },
lineStyle: { color: '#999', type: 'dashed' }
}
}
});Item トリガーのツールチップ
trigger: 'item' は単一のデータポイント(円のスライス、散布図のポイント)をホバーしたときツールチップを示します。pie、scatter、radar のデフォルトです。extraCssText でカスタムスタイリングのために任意の CSS(影、角丸)を加えられます。pie では percent が使えます。アイテムのツールチップはポイントごとに正確です。
chart.setOption({
tooltip: {
trigger: 'item', // per-point, not per-axis
formatter: function (p) {
return p.name + ': ' + p.value + ' (' + p.percent + '%)';
},
backgroundColor: 'rgba(255,255,255,0.95)',
borderColor: '#eee',
textStyle: { color: '#333' },
extraCssText: 'box-shadow: 0 2px 10px rgba(0,0,0,0.1);'
},
series: [{
type: 'pie',
data: [{ value: 60, name: 'A' }, { value: 40, name: 'B' }]
}]
});リッチコンテンツのツールチップ
複数系列の軸ツールチップでは、params が配列です。反復して、色マーカー、値、整形を持つリッチな HTML テーブルを組み立てましょう。整列、合計、単位を持つプロフェッショナルなツールチップはこのように作ります。HTML を返せばインライン CSS で完全にスタイルを制御できます。
chart.setOption({
tooltip: {
trigger: 'axis',
axisPointer: { type: 'shadow' },
formatter: function (params) {
let html = '<div style="font-weight:bold;margin-bottom:4px;">'
+ params[0].name + '</div>';
params.forEach(p => {
html += '<div style="display:flex;align-items:center;">'
+ '<span style="display:inline-block;width:10px;height:10px;background:'
+ p.color + ';margin-right:6px;"></span>'
+ p.seriesName + ': ' + p.value
+ '</div>';
});
return html;
}
},
series: [
{ type: 'bar', name: 'A', data: [10, 20, 30] },
{ type: 'bar', name: 'B', data: [15, 25, 35] }
]
});Toolbox
Toolbox の機能
Toolbox はアクションアイコンを加えます(デフォルトでは右上)。dataZoom でドラッグ選択によるズーム、dataView で生データ表示(readOnly: false なら編集可能)、magicType でチャートタイプ切り替え(line/bar)、restore でリセット、saveAsImage で PNG/SVG エクスポートができます。各機能には独自の設定があります。
chart.setOption({
toolbox: {
show: true,
right: 10, top: 10,
feature: {
dataZoom: { yAxisIndex: 'none' },
dataView: { readOnly: false, title: 'Data', lang: ['Data','Close','Refresh'] },
magicType: { type: ['line','bar','stack','tiled'] },
restore: {},
saveAsImage: { pixelRatio: 2, name: 'chart', type: 'png' }
}
},
series: [{ type: 'bar', data: [10, 20, 30] }]
});Toolbox 経由の Data Zoom
Toolbox の dataZoom はドラッグ選択用の「ズームイン/アウト」ボタンを加えます。dataZoom コンポーネントと組み合わせましょう:'inside'(マウス/タッチジェスチャ)と 'slider'(ドラッグ可能なバー)。yAxisIndex: 'none' でズームを x に限定します。数千ポイントの時系列では、ナビゲーションに dataZoom が不可欠です。
chart.setOption({
toolbox: {
feature: {
dataZoom: {
yAxisIndex: 'none', // only zoom x axis
title: { zoom: 'Zoom In', back: 'Zoom Out' }
}
}
},
dataZoom: [
{ type: 'inside', xAxisIndex: 0 }, // mouse wheel
{ type: 'slider', xAxisIndex: 0 } // slider below chart
],
xAxis: { type: 'category', data: longData },
series: [{ type: 'line', data: longData }]
});Data View(生データの編集)
dataView はチャートの背後のデータを示します。readOnly: false ならユーザーが編集して再描画できます。optionToContent/contentToOption でビューを完全にカスタマイズできます(JSON の代わりに HTML テーブルなど)。デバッグや、上級ユーザーによるデータ調整に有用です。編集は再描画をトリガーします。
chart.setOption({
toolbox: {
feature: {
dataView: {
readOnly: false, // editable
title: 'View Data',
lang: ['Data View', 'Close', 'Refresh'],
optionToContent: function (opt) {
// custom HTML rendering instead of JSON
return '<div>Custom view</div>';
},
contentToOption: function (div) {
// parse edited content back to option
return opt;
}
}
}
}
});Magic Type と Restore
magicType でユーザーが実行時に line/bar と積み上げ/並列レイアウトを切り替えられます — ECharts が変換を処理します。restore が toolbox のすべての変更を元の option へ戻します。magicTypeChanged イベントでタイプ切り替えに反応できます(ラベル更新など)。追加コードなしで探索できます。
chart.setOption({
toolbox: {
feature: {
magicType: {
type: ['line', 'bar', 'stack', 'tiled'],
title: { line: 'Line', bar: 'Bar', stack: 'Stack', tiled: 'Tile' }
},
restore: { title: 'Restore' }
}
},
series: [
{ type: 'bar', name: 'A', data: [10, 20, 30] },
{ type: 'bar', name: 'B', data: [15, 25, 35] }
]
});
chart.on('magicTypeChanged', function (params) {
console.log('Switched to', params.currentType);
});画像として保存
saveAsImage はチャートを PNG/JPG としてエクスポートします。pixelRatio: 2 で retina 向けに解像度が 2 倍になります。excludeComponents でエクスポートから要素(toolbox など)を除外します。getDataURL はプログラム的なダウンロードやアップロードのための base64 文字列を 返します。type が 'svg' のとき、SVG レンダラーはよりきれいなベクター画像をエクスポートします。
chart.setOption({
toolbox: {
feature: {
saveAsImage: {
type: 'png', // 'png' or 'jpg'
name: 'my-chart',
pixelRatio: 2, // higher = sharper
backgroundColor: '#fff',
excludeComponents: ['toolbox'],
title: 'Download'
}
}
}
});
// programmatic export
chart.getDataURL({
type: 'png',
pixelRatio: 2,
backgroundColor: '#fff'
});マーク(MarkPoint / MarkLine / MarkArea)
MarkPoint(ポイントのハイライト)
markPoint は特定のポイントに注意を引きます。組み込みタイプ:'max'、'min'、'average'。カスタムポイントには coord: [x, y] も指定できます。symbolSize がマーカーを拡縮します。MarkPoint は系列の上に浮きます — 軸のスケーリングに影響しません。極値やイベントの強調に有用です。
chart.setOption({
series: [{
type: 'line',
data: [10, 50, 30, 80, 20, 90],
markPoint: {
symbolSize: 50,
data: [
{ type: 'max', name: 'Peak' },
{ type: 'min', name: 'Low' },
{ type: 'average', name: 'Avg' }
],
label: { fontSize: 12 }
}
}]
});MarkLine(参照線)
markLine は参照線を引きます。type: 'average' が平均の位置に水平線を引き、{ yAxis: 60 } がカスタムの水平線(しきい値、ターゲット)を、{ xAxis: 'Wed' } が垂直線(イベントマーカー)を引きます。きれいな見た目のため矢印を消すには symbol: 'none' を。
chart.setOption({
series: [{
type: 'bar',
data: [10, 50, 30, 80, 20],
markLine: {
symbol: 'none', // no end arrows
lineStyle: { type: 'dashed', color: '#ee6666' },
data: [
{ type: 'average', name: 'Avg' },
{ yAxis: 60, name: 'Threshold' }, // horizontal line at y=60
{ xAxis: 'Wed', name: 'Event' } // vertical line at category
],
label: { formatter: '{b}: {c}' }
}
}]
});MarkArea(領域のハイライト)
markArea はチャートの領域を色付けします。data は [start, end] ペアの配列です — 各ペアが coord(xAxis/yAxis の値)で長方形を定義します。営業時間、週末、不況、注目すべき期間のハイライトに有用です。silent: false でホバーイベントに反応させられます。
chart.setOption({
series: [{
type: 'line',
data: [10, 20, 30, 40, 50, 60, 70],
markArea: {
silent: false,
itemStyle: { color: 'rgba(255, 200, 0, 0.2)' },
data: [
[
{ xAxis: 'Tue' }, // start
{ xAxis: 'Thu' } // end
],
[
{ xAxis: 'Fri' },
{ xAxis: 'Sat' }
]
],
label: { show: true, position: 'top' }
}
}]
});マークの組み合わせ
1 つの系列に markPoint、markLine、markArea を組み合わせられます。典型的な分析チャートは、ピーク(markPoint)をハイライトし、平均とターゲット(markLine)を示し、注目すべき期間(markArea)を色付けします。各マークは独立したスタイルを持ちます。やりすぎには注意 — マークが多すぎるとチャートが雑然とします。
chart.setOption({
series: [{
type: 'line',
data: [20, 50, 30, 80, 60, 90, 40],
markPoint: {
data: [{ type: 'max', name: 'Max' }]
},
markLine: {
data: [
{ type: 'average', name: 'Average' },
{ yAxis: 70, name: 'Target', lineStyle: { color: '#91cc75' } }
]
},
markArea: {
data: [[
{ xAxis: 'Wed' },
{ xAxis: 'Fri', itemStyle: { color: 'rgba(145,204,117,0.1)' } }
]]
}
}]
});カスタム座標のマーク
カスタム位置には、組み込みタイプの代わりに coord: [x, y] を使います。カスタム座標の markLine は 2 つの coord オブジェクト(始点と終点)の配列を取ります — 任意の線(対角線、回帰からのトレンドライン)が引けます。symbol: 'pin' で markPoint の形状が変わります。特定のデータポイン トへの注釈が可能になります。
chart.setOption({
series: [{
type: 'scatter',
data: [[10,20], [50,60], [80,90]],
markPoint: {
data: [
{ coord: [50, 60], name: 'Center', value: 'Origin' }
],
symbol: 'pin',
symbolSize: 40,
itemStyle: { color: '#ee6666' }
},
markLine: {
data: [
[{ coord: [0, 0] }, { coord: [100, 100] }] // diagonal line
]
}
}]
});アニメーションとインタラクション
アニメーションのオプション
アニメーションはグローバルに制御します。animationDuration が登場アニメーションの長さです。イージング名には 'linear'、'cubicOut'、'elasticOut'、'bounceOut' があります。関数としての animationDelay がアイテムを段階化します(idx * 100 で各バーが前のバーの 100ms 後に現れる)。大きな dataset では、パフォーマンス維持のため animationThreshold がアニメーションを自動無効化します。
chart.setOption({
animation: true,
animationThreshold: 2000, // disable above this data count
animationDuration: 2000, // entrance duration (ms)
animationEasing: 'cubicOut', // easing function
animationDelay: function (idx) { // stagger by index
return idx * 100;
},
animationDurationUpdate: 500, // update transition
animationEasingUpdate: 'cubicInOut',
animationDelayUpdate: 0,
series: [{ type: 'bar', data: [10, 20, 30, 40] }]
});イージング関数
ECharts は 30 以上のイージング関数をサポートします。'cubicOut'(デフォルト)は自然な減速です。'elasticOut' と 'bounceOut' は遊び心のある行き過ぎを加えます。'sinusoidalInOut' は滑らかで中立的です。データ可視化には控えめなイージング(cubic、sinusoidal)を推奨します — 跳ねるアニメーションはデータから注意を逸らします。ブランドの個性に合わせましょう。
chart.setOption({
animationEasing: 'elasticOut',
// available easings:
// linear, quadraticIn, quadraticOut, quadraticInOut,
// cubicIn, cubicOut, cubicInOut,
// quarticIn, quarticOut, quarticInOut,
// quinticIn, quinticOut, quinticInOut,
// sinusoidalIn, sinusoidalOut, sinusoidalInOut,
// exponentialIn, exponentialOut, exponentialInOut,
// circularIn, circularOut, circularInOut,
// elasticIn, elasticOut, elasticInOut,
// backIn, backOut, backInOut,
// bounceIn, bounceOut, bounceInOut
series: [{ type: 'bar', data: [10, 20, 30] }]
});ローディングアニメーション
showLoading はデータ取得中にスピナーのオーバーレイを表示します。データが揃ったら hideLoading を呼びましょう。標準的な非同期データのパターンです — ローディング表示、取得、ローディング非表示、setOption。アプリに合わせてスピナーの色とメッセージをカスタマイズしましょう。マスクが読み込み中のユーザー操作を防ぎます。
// show loading mask
chart.showLoading({
text: 'Loading data...',
color: '#5470c6',
textColor: '#333',
maskColor: 'rgba(255, 255, 255, 0.8)',
zlevel: 0,
fontSize: 14,
showSpinner: true,
spinnerRadius: 10,
lineWidth: 2
});
// hide after data loads
fetch('/api/data').then(r => r.json()).then(data => {
chart.hideLoading();
chart.setOption({ series: [{ type: 'bar', data: data }] });
});Events API
chart.on がイベントハンドラを束縛します。よくあるイベント:click、dblclick、mouseover、legendselectchanged、datazoom、pieselectchanged。params がコンポーネント情報を運びます。dispatchAction がアクション(highlight、showTip、dataZoom)をトリガーします — 外部 UI とチャートの同期や、プログラム的なツールチップ表示に有用です。
chart.on('click', function (params) {
console.log('Clicked:', params.componentType, params.seriesType);
console.log('Series:', params.seriesName, 'Data:', params.name, params.value);
console.log(' dataIndex:', params.dataIndex);
});
chart.on('legendselectchanged', function (params) {
console.log('Legend toggled:', params.selected);
});
chart.on('datazoom', function (params) {
console.log('Zoom:', params.batch?.[0]?.start, params.batch?.[0]?.end);
});
// dispatch an action programmatically
chart.dispatchAction({
type: 'highlight',
seriesIndex: 0,
dataIndex: 2
});
chart.dispatchAction({ type: 'showTip', x: 100, y: 100 });Graphic 要素(カスタム形状)
graphic でチャートの上にカスタム形状(テキスト、円、長方形、画像)を重ねられます — ウォーターマーク、空状態メッセージ、注釈に有用です。要素は位置(px か % の left/top/right/bottom)、スタイル、イベントをサポートします。z に応じてチャートの上か下に描画されます。標準オプションが足りないときの逃げ道です。
chart.setOption({
graphic: {
elements: [
{
type: 'text',
left: 'center', top: 'middle',
style: { text: 'No Data', fontSize: 24, fill: '#999' },
invisible: false
},
{
type: 'circle',
shape: { cx: 50, cy: 50, r: 20 },
style: { fill: '#5470c6' },
onclick: function () { console.log('clicked'); }
},
{
type: 'image',
style: { image: 'logo.png', width: 100, height: 40 },
left: 10, top: 10
}
]
}
});関連する ECharts スニペット
Copy-paste ready code for common tasks.
Bar Chart
Category bar chart with axis tooltip and styled bars.
Line Chart
Smooth multi-series line chart with area fill.
Pie Chart
Donut-style pie with emphasis effect and percentage labels.
Scatter Plot
Scatter plot with point size encoded by a third dimension.
Radar Chart
Radar with multiple indicators and overlaid value series.
Options & Series
Dataset-driven multi-series chart with grid and legend config.
Tooltip
Custom HTML tooltip with crosshair axis pointer.
Responsive
Resize chart on window and container changes, with cleanup.
Was this helpful?