매출 대시보드
KPI 카드, 복합 차트, 도넛, 히트맵, 퍼널까지 차트 8개. 차트 하나에 옵션 몇 개씩이고, 월별 · 분기별 버튼은 update() 한 번입니다.
캔버스 차트 26종을 옵션 객체 하나로 그리는 라이브러리입니다. 사용법은 하나뿐이고, React · Vue · Svelte · jQuery에서도 이름과 옵션이 같습니다.
@aeriz/chart는 캔버스 차트 26종을 옵션 객체 하나로 그립니다. 컨테이너와 데이터만 넘기면 축 · 범례 · 툴팁 · 애니메이션 · 테마는 기본값이 맡습니다.
data, 바꿀 때는 update(), 상태는 setState(). 26종 · 다섯 환경 모두 같습니다.2.1.1 새 기능 툴팁의 링크 · 버튼과 직접 그리기, 범례 클릭 바꾸기, 가리키는 항목 받기. 2.1 코드는 그대로 돕니다.
2.1 새 기능 기준선 · 구간, 확대 · 브러시, 동기화, 100% 누적, 오차 막대, 여러 값 축, 캔들스틱 · 트리맵 · 선버스트 · 생키 · 네트워크 · 지도. 2.0 코드는 그대로 돕니다.
실제 서비스 화면처럼 만든 예제입니다. 모두 이 페이지에서 돌아가고, JS · HTML · CSS 탭이 그 화면을 만든 코드 전부입니다. 차트 하나는 new 차트(요소, { data })에 옵션 몇 개면 됩니다. 차트 종류별 모양은 차트 종류에 있습니다.
KPI 카드, 복합 차트, 도넛, 히트맵, 퍼널까지 차트 8개. 차트 하나에 옵션 몇 개씩이고, 월별 · 분기별 버튼은 update() 한 번입니다.
오른쪽 축이 있는 4겹 복합 차트, 누적 영역, ARR 브리지, 코호트 리텐션, 사분위 분포, 점 20,000개, 칸 8,760개 히트맵까지 차트 9개. 세그먼트 버튼 하나로 전부 update()됩니다.
신규 가입(막대)과 8주 이동평균(영역)은 왼쪽 축, 전환율(선)은 오른쪽 % 축입니다. 빨간 점은 평균에서 많이 벗어난 주입니다.
범례를 눌러 채널을 빼 보세요. 나머지가 다시 쌓입니다.
기초에서 신규 · 확장 · 축소 · 이탈을 거쳐 기말까지.
아직 오지 않은 달은 비워 둡니다(null).
세션 8,000건에서 사분위수와 이상치를 직접 계산.
설문 6개 항목, 10점 만점.
점마다 요금제 색. 마우스를 올리면 한 명씩 집힙니다.
점 구름과 같은 데이터에서 셉니다.
주말과 출퇴근 시간이 보입니다. 칸마다 툴팁이 있습니다.
왼쪽 지역 막대를 누르면 onClick이 나머지 차트를 그 지역으로 바꾸고, 1초 단위 거래 1,000,000건을 새로 만들어 다시 그립니다. 걸린 시간이 위에 그대로 찍힙니다.
0.1초마다 값이 흘러가는 실시간 선, 게이지 3개, API별 응답 시간. "장애 흉내 내기"를 눌러 보세요.
같은 차트를 흰 종이 위에 두면 글자색과 배경을 읽어 밝은 테마가 됩니다. 브랜드 색은 CSS 변수 두 줄입니다.
전체 만족도는 4.3점(5점 만점)으로 지난해보다 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 패키지에는 압축한 빌드(dist/)와 TypeScript 타입만 들어 있습니다.
import → 차트마다 나뉜 dist/esm/require → dist/aeriz.min.cjsdist/aeriz.min.js압축은 지역 이름만 줄입니다. 옵션 이름, 메서드, 차트 이름, 오류 메시지는 그대로 읽힙니다.
Tip CDN 주소에는 @2.1.1처럼 정확한 버전을 적으세요. 바뀌지 않는 주소라 1년 동안 캐시됩니다.
높이가 있는 요소 하나와 데이터만 있으면 됩니다. 높이가 없으면 320px로 잡습니다.
<div id="sales" style="height: 260px"></div>
<script type="module">
import { BarChart } from '@aeriz/chart';
const chart = new BarChart('#sales', {
data: { '1월': 64, '2월': 42, '3월': 78, '4월': 55, '5월': 90, '6월': 71 },
});
chart.update({ data: { '1월': 30, '2월': 80 } }); // 바뀐 값으로 부드럽게 다시 그림
</script>막대에 마우스를 올리거나, 차트를 누른 뒤 ← → 키로 값을 읽어 보세요.
모든 차트가 같은 네 가지만 씁니다. 같은 일을 하는 다른 이름은 없습니다.
| 할 일 | 방법 |
|---|---|
| 만들기 | new BarChart(요소 또는 선택자, 옵션) |
| 데이터 · 옵션 바꾸기 | chart.update({ data, … }) — 바뀐 것만 넘기면 되고, 값이 애니메이션으로 바뀝니다 |
| 불러오는 중 · 비어 있음 · 오류 | chart.setState('loading' | 'empty' | 'error', 문구?), 닫을 때 chart.setState(null) |
| 지금 바로 다시 그리기 | chart.render() — CSS 변수를 다시 읽고 마지막 모습을 즉시 그립니다(화면 밖이어도) |
| 없애기 | chart.destroy() — 요소를 원래대로 돌려놓습니다 |
RealtimeChart만 값을 흘려 넣는 push()와 비우는 clear()가 더 있습니다.
데이터는 언제나 data 옵션 하나로 넘깁니다. 차트가 그리는 것에 따라 모양이 정해져 있습니다.
Bar, HBar, Line, Sparkline, Pie, Polar, Funnel, Treemap, Sunburst, Map은 아래 세 모양을 받습니다. 셋 다 같은 뜻입니다.
new BarChart(el, { data: [64, 42, 78] }); // 숫자 배열 → 이름 1, 2, 3
new BarChart(el, { data: { '1월': 64, '2월': 42 } }); // 객체 → 키가 이름
new BarChart(el, { data: [{ label: '1월', value: 64 }] }); // 행
// 가진 행의 필드 이름이 다르면 읽는 법만 알려 주세요
new BarChart(el, { data: rows, label: (r) => r.month, value: (r) => r.sales });Area, StackedBar, GroupedBar, MultiLine, Radar, Composite는 categories와 series를 data 안에 담습니다. 시리즈마다 값의 개수는 categories와 같아야 합니다. 오차 막대 · 구간은 행이나 시리즈에 low · high를 더합니다(오차 막대).
new GroupedBarChart(el, {
data: {
categories: ['1분기', '2분기', '3분기'],
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 옵션 — 지도 |
틀린 옵션이나 맞지 않는 데이터는 조용히 빈 차트가 되지 않습니다. 개발자 도구 콘솔에 무엇이 틀렸고 어떻게 고치는지 한 번씩 나옵니다.
[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] "가입" 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 — "환불" 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)가 쓰지 않는 차트를 빼냅니다. 평소처럼 가져오면 됩니다. React · Vue · Svelte 연동에서 가져와도 마찬가지입니다.
import { BarChart, PieChart } from '@aeriz/chart'; // 이 두 차트와 공통 코어만 번들에 들어감번들러 없이 쓰거나 확실하게 하나만 받고 싶으면 차트 경로로 가져옵니다.
import { BarChart } from '@aeriz/chart/bar';
import { SparklineChart } from '@aeriz/chart/sparkline';| 가져오는 것 | 크기 (min + gzip) |
|---|---|
| 축 없는 차트 1종 (Gauge, Pie, Funnel …) | 약 12 KB |
| 계층 · 흐름 · 지도 1종 (Treemap, Sunburst, Sankey, Network, Map) | 약 12~13 KB |
| 축 있는 차트 1종 (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로 번들한 값입니다. 공통 코어(캔버스, 테마, 툴팁, 범례, 입력 처리, 실수 경고)는 여러 차트가 같이 쓰므로 차트를 더해도 크게 늘지 않습니다.
경로 목록: 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
다섯 환경 모두 차트 이름과 옵션이 같습니다. 프레임워크 없이 쓸 때는 클래스를 그대로 씁니다.
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에서 차트와 같은 이름의 컴포넌트를 가져옵니다. 옵션은 모두 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: 'KRW' }}
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에서 차트와 같은 이름의 컴포넌트를 가져옵니다. 옵션은 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(요소)를 쓰세요.
쓸 차트를 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) | squarified 배치, 계층은 머리줄 달린 묶음 |
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) | 고리마다 한 단계, 가운데에 몫 |
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'], // 처음엔 최근 석 달
colors: { up: '#ef4444', down: '#3b82f6' }, // 국내 증시처럼 (기본은 초록 · 빨강)
annotations: [{ y: 80000, label: '목표가 80,000' }],
});끌어서 확대하고, Shift를 누른 채 끌거나 가로로 스크롤해 옮겨 보세요. 두 번 누르면 전체로 돌아갑니다.
캔들이 3 px보다 가늘어지면 심지만 그리고, 마우스는 픽셀 한 칸마다 가장 가까운 캔들을 찾으므로 몇만 개도 가볍습니다. 가로축은 이름('8/3') 또는 xScale: 'time'과 ms 시각입니다. 시가나 종가가 저가~고가 밖이면 콘솔에 알려 줍니다.
TreemapChart와 SunburstChart는 같은 데이터를 받습니다. 행에 children이 있으면 묶음이 되고, 묶음의 값은 자식 값의 합입니다. 깊이 제한은 없습니다.
const budget = [
{ label: '개발', children: [{ label: '서버', value: 42 }, { label: '앱', value: 30 }, { label: '데이터', value: 18 }] },
{ label: '마케팅', children: [{ label: '광고', value: 25 }, { label: '행사', value: 9 }, { label: '콘텐츠', value: 7 }] },
{ label: '운영', children: [{ label: '고객 지원', value: 14 }, { label: '사무', value: 8 }] },
{ label: '기타', value: 6 },
];
new TreemapChart('#budget-tree', { data: budget, onClick: (hit) => console.log(hit.path) }); // ['개발', '서버']
new SunburstChart('#budget-sun', { data: budget });{ JS: 42, TS: 30 })는 2.0과 똑같이 그립니다.개발 › 서버: 42억)를 보여 주고, onClick의 hit.path에도 같은 경로가 들어 있습니다.단계 사이의 흐름을 값만큼 두꺼운 띠로 그립니다. 노드는 링크에서 만들어지고, 처음 노드에서 가장 긴 경로만큼 오른쪽 열에 놓입니다. 나가는 흐름이 없는 노드는 마지막 열입니다.
new SankeyChart('#journey', {
data: {
links: [
{ source: '검색', target: '상품 페이지', value: 520 },
{ source: '광고', target: '상품 페이지', value: 300 },
{ source: '상품 페이지', target: '장바구니', value: 410 },
{ source: '장바구니', target: '구매', value: 330 },
// …
],
nodes: [{ id: '구매', color: '#10b981' }], // 이름(label)이나 색을 바꿀 때만
},
});되돌아가는 링크(순환)는 생키에 그릴 수 없어 빼고, 콘솔에 어느 링크인지 알려 줍니다. 띠나 노드에 마우스를 올리면 그 흐름이 강조되고, 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). 툴팁의 나라 이름은 labelFormat으로 한국어로 바꿨습니다.
projection: 'mercator'(기본)와 'equirectangular'입니다. 지도는 크기마다 한 번만 계산해 두고, 마우스는 모양 그대로(구멍과 섬까지) 맞춥니다.colors: { low, high }이고, 값이 없는 지역은 옅은 회색입니다. 아래에 색 범례가 붙습니다(legend: false로 숨김)."Korea" 대신 "KOR"를 썼는지 확인).properties에 영어 이름(name), 한국어 이름(ko), 1인당 GDP(gdp)가 있습니다. 남극은 뺐습니다.RealtimeChart에 값을 push()하면 오른쪽 끝에 붙고, window를 넘은 값은 왼쪽으로 빠집니다.
const rt = new RealtimeChart('#cpu', { data: { series: [{ name: 'CPU' }, { name: '메모리' }] }, window: 120, max: 100 });
setInterval(() => rt.push([cpu(), memory()]), 100);LineChart는 점이 화면 픽셀보다 훨씬 많으면 픽셀 한 칸마다 최솟값과 최댓값만 남겨 그립니다. 모양은 그대로이고, 툴팁은 원래 점의 값을 보여 줍니다. 계산 결과는 데이터가 바뀔 때까지 재사용하므로 마우스를 움직여도 다시 계산하지 않습니다.
버튼을 누르면 데이터를 만들고 그리는 시간을 잽니다.
값 축이 있는 차트는 annotations로 선과 띠를 그립니다. 값 하나는 점선, [시작, 끝]은 띠입니다. y는 값 축에, x는 가로축(이름 · 시간 · 숫자)에 놓입니다.
new LineChart('#latency', {
data: latency, // 시간별 응답 시간
annotations: [
{ y: 300, label: 'SLO 300 ms', color: '#ef4444' }, // 목표선
{ y: [80, 160], label: '평소 범위' }, // 구간
{ x: '14시', label: '배포' }, // 세로 기준선
],
});y만). 다른 차트에 주면 콘솔이 알려 줍니다.label은 가로선이면 오른쪽 끝 위에(맨 위의 선이면 아래에), 세로선이면 위쪽에 놓이고, color는 선 · 띠 · 글자에 같이 씁니다(기본은 흐린 글자색).x가 값, y가 항목 이름입니다. CompositeChart는 axis로 어느 값 축의 선인지 고릅니다(여러 값 축).update({ annotations })는 애니메이션 없이 선만 다시 그립니다.zoom: true를 주면 가로축을 확대하고 옮길 수 있습니다. 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), // 사용자가 바꿀 때마다 [시작, 끝] 또는 null
});
chart.update({ range: null }); // 코드로 전체 보기차트 위를 가로로 끌어 보세요.
| 마우스 · 트랙패드 | 터치 | 키보드 (차트에 포커스) | |
|---|---|---|---|
| 확대 | 끌어서 범위 고르기 · Ctrl/⌘ + 휠 · 핀치 | 두 손가락 벌리기 | + |
| 축소 | Ctrl/⌘ + 휠 · 핀치 | 두 손가락 오므리기 | - |
| 옮기기 | Shift + 끌기 · 가로 스크롤 | 확대한 뒤 한 손가락으로 끌기 | Shift + ← → |
| 전체로 | 두 번 클릭 · 오른쪽 위 버튼 | 오른쪽 위 버튼 | 0 |
휠만 굴리면 페이지가 스크롤되고, 확대하지 않은 차트를 한 손가락으로 끌면 툴팁을 보여 주므로 페이지 스크롤을 막지 않습니다. range는 가로축 단위로 씁니다: 이름 축은 ['3월', '5월'], 시간축은 ms, 숫자 축(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에 같은 이름을 준 차트끼리 십자선과 확대 범위를 같이 씁니다. 가로축의 같은 값(이름 · 시간 · 숫자)을 찾아 맞추므로 차트 종류나 데이터 길이가 달라도 됩니다.
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 });한 차트에 마우스를 올리거나 끌어서 확대하면 나머지 둘이 따라옵니다.
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 배열을 줍니다. 값 축은 구간까지 보이게 넓어지고, 툴팁에 값 (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: ['1월', '2월', '3월', …],
series: [
{ type: 'bar', name: '온라인', values: online }, // 왼쪽 축
{ type: 'bar', name: '매장', values: store }, // 같은 축이라 위에 쌓임
{ type: 'line', name: '이익률', values: margin, axis: 'margin', format: { style: 'percent' } },
{ type: 'line', name: '방문자', 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) | 사용자가 범위를 바꿀 때 | 주소에 범위 남기기, 다른 화면 맞추기 — 확대 |
tooltip.actions(hit, chart) | 툴팁을 만들 때 (항목마다 한 번) | 툴팁 아래 링크 · 버튼 |
tooltip.render(hit, chart) | 툴팁을 만들 때 (항목마다 한 번) | 툴팁 내용 직접 그리기 |
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)가 돌려주는 것이 툴팁 내용이 됩니다. 항목마다 한 번 불리고, 마우스가 그 항목에 있는 동안은 다시 부르지 않습니다. 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: '서울', 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], // 네 번째 시리즈는 꺼 둔 채로 시작
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)는 가리키는 항목이 바뀔 때 한 번씩 불리고, 차트에서 벗어나면 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만 불립니다. 따라 그려지는 십자선은 부르지 않습니다.설정하지 않으면 차트를 넣은 요소의 글자색, 글꼴, 배경을 읽어 격자와 축 색을 만듭니다. 그래서 밝은 페이지와 어두운 페이지 모두에서 그대로 어울리고, 운영체제의 다크 모드가 바뀌면 다시 읽습니다. 바꾸고 싶은 값만 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: 'Pretendard', 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'] 옵션을 씁니다. 막대 하나하나의 색은 행에 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은 이름(가로축 라벨과 툴팁 제목)의 형식입니다. 축마다 따로 정하는 옵션은 없습니다.
{ format: { style: 'currency', currency: 'KRW' } } // ₩1,234
{ format: { style: 'percent' } } // 0.25 → 25%
{ format: (v) => v.toFixed(1) + '℃' } // 함수
{ labelFormat: (t) => new Date(t).getHours() + '시' } // 시간축 라벨1.2만, 영어 12K). 고정하려면 함수로: format: (v) => v.toLocaleString('ko-KR')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 옵션 | (v) => string | 브라우저 언어 | 툴팁과 값 축의 숫자 형식 |
labelFormat | (label) => string | — | 가로축 라벨과 툴팁 제목 (축이 있는 차트) |
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 | [시작, 끝] | null | 전체 | 보여 줄 가로축 범위 (위 차트들, 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: [최소, 최대] 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: [최소, 최대] 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, 문구?) |
invalidate() | render() |
Gauge setValue(v) · value · label | update({ data: v }) · data · title |
categories · series · layers · axes (옵션) | 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: '문구' |
Pie innerRadius: 80(px) · 'auto' | innerRadius: 0.6 (비율만) |
Waterfall isTotal | total |
Scatter r · Bubble z | size |
Composite 점 values: [{ x, y }] | 다른 시리즈처럼 values: [값 | null] |
[['1월', 64], …] 쌍 데이터 | { '1월': 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={…} {…옵션} /> (/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 | 내보내지 않음 (내부용) |