Начало работы
Настройка и первый график
Chart.js рендерит на элементе canvas. Свойство type задаёт тип графика. data содержит labels и datasets со значениями и стилями.
<!-- include Chart.js -->
<script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
<canvas id="myChart" width="400" height="400"></canvas>
<script>
const ctx = document.getElementById('myChart').getContext('2d');
new Chart(ctx, {
type: 'bar',
data: {
labels: ['Red', 'Blue', 'Green'],
datasets: [{
label: 'Votes',
data: [12, 19, 3],
backgroundColor: ['red', 'blue', 'green']
}]
}
});
</script>Установка через npm и импорт ES-модуля
Используйте 'chart.js/auto' для простейшей настройки — он импортирует Chart.js вместе со всеми контроллерами/элементами и регистрирует их автоматически. Для меньших продакшен-бандлов предпочитайте tree-shaking: импортируйте из 'chart.js' и регистрируйте только используемое.
# install
npm install chart.js
// import the auto-bundled build (registers everything)
import Chart from 'chart.js/auto';
const ctx = document.getElementById('myChart');
const chart = new Chart(ctx, {
type: 'line',
data: { /* ... */ },
options: { responsive: true }
});Canvas и 2D-контекст
Chart.js принимает как сам элемент <canvas>, так и его 2d-контекст рендеринга. При responsive: true canvas растягивается под контейнер, поэтому HTML-атрибуты width/height — лишь запасные варианты. Каждому canvas принадлежит ровно один экземпляр Chart.
// Chart.js accepts a canvas element OR a 2D context
const canvas = document.getElementById('myChart');
const chart = new Chart(canvas, { type: 'bar', data: {...} });
// equivalent: pass the 2d context
const ctx = canvas.getContext('2d');
const chart2 = new Chart(ctx, { type: 'bar', data: {...} });
// one chart per canvas; the canvas size is controlled by
// responsive options, NOT the width/height attributesДоступные типы графиков
Chart.js поставляется с восемью типами графиков. Bar, line, scatter и bubble используют декартовы оси; pie, doughnut и polarArea — круговые; radar имеет собственную радиальную ось. Поле 'type' верхнего уровня выбирает контроллер для всех dataset, если конкретный dataset не переопределяет его своим type.
// the 8 built-in chart types
const types = ['bar', 'line', 'pie', 'doughnut',
'radar', 'polarArea', 'bubble', 'scatter'];
// each type maps to a controller:
// bar/line -> Cartesian controllers
// pie/doughnut/polarArea -> circular controllers
// radar -> radar controller
// bubble/scatter -> cartesian with point parsing
new Chart(ctx, { type: 'polarArea', data: {...} });Tree-shaking и регистрация
При импорте из 'chart.js' (не /auto) ничего не регистрируется — придётся самому регистрировать контроллеры, элементы, шкалы и плагины. Такой tree-shakeable подход может заметно уменьшить размер бандла. Забытая регистрация компонента — самая частая причина ошибки «scale is not a registered scale».
import {
Chart,
BarController,
BarElement,
CategoryScale,
LinearScale,
Legend,
Title,
Tooltip,
} from 'chart.js';
// register ONLY what you use -> smaller bundle
Chart.register(
BarController, BarElement,
CategoryScale, LinearScale,
Legend, Title, Tooltip,
);
new Chart(ctx, {
type: 'bar',
data: { labels: ['A', 'B'], datasets: [{ data: [1, 2] }] },
});Уничтожение и жизненный цикл
Каждый экземпляр Chart владеет своим canvas и привязанными слушателями событий. Вызов destroy() разбирает всё, и canvas можно использовать снова — обязательно в SPA и эффектах React/Vue. Второй график на активном canvas даёт утечку памяти и двойной рендер графики.
const chart = new Chart(ctx, config);
// ...later, to re-render with new config:
chart.destroy(); // cleans up listeners and canvas
const fresh = new Chart(ctx, newConfig);
// never create two Chart instances on the same canvas;
// always destroy() the old one first.Столбчатые диаграммы (Bar)
Базовая bar-диаграмма
Bar-диаграмма сопоставляет каждой метке столбец, высота которого равна значению данных. backgroundColor задаёт заливку столбца, borderColor/borderWidth — контур. Установите y.beginAtZero, чтобы столбцы в сегда начинались с нуля — иначе Chart.js может автоматически подстроить минимум оси и визуально исказить различия.
new Chart(ctx, {
type: 'bar',
data: {
labels: ['Jan', 'Feb', 'Mar', 'Apr', 'May'],
datasets: [{
label: 'Revenue',
data: [12, 19, 7, 15, 22],
backgroundColor: 'rgba(54, 162, 235, 0.6)',
borderColor: 'rgba(54, 162, 235, 1)',
borderWidth: 1
}]
},
options: { scales: { y: { beginAtZero: true } } }
});Горизонтальные столбцы (indexAxis)
В Chart.js v3+ горизонтальные столбцы создаются через indexAxis: 'y' для типа 'bar' — старый тип 'horizontalBar' удалён. Шкала x становится осью значений. Горизонтальные столбцы идеальны для длинных подписей категорий, которые перекрывались бы на вертикальной диаграмме.
new Chart(ctx, {
type: 'bar',
data: {
labels: ['Task A', 'Task B', 'Task C'],
datasets: [{ label: 'Hours', data: [5, 8, 3] }]
},
options: {
indexAxis: 'y', // horizontal bars (v3+ syntax)
scales: { x: { beginAtZero: true } }
}
});Группированные столбцы (несколько dataset)
Несколько dataset в bar-диаграмме по умолчанию ставятся рядом (группами). Chart.js назначает цвета автоматически, только если опустить backgroundColor, поэтому задавайте явные цвета для предсказуемого результата. Все dataset делят один массив labels на оси x.
new Chart(ctx, {
type: 'bar',
data: {
labels: ['Q1', 'Q2', 'Q3', 'Q4'],
datasets: [
{ label: '2023', data: [20, 35, 30, 35],
backgroundColor: 'rgba(255,99,132,0.6)' },
{ label: '2024', data: [25, 32, 34, 40],
backgroundColor: 'rgba(54,162,235,0.6)' }
]
},
options: { scales: { y: { beginAtZero: true } } }
});Стековые столбцы
Стековым столбцам требуется stacked: true ОДНОВРЕМЕННО на шкалах x и y. Столбцы каждого dataset рисуются поверх предыдущего, суммируясь в общий итог. Стек показывает состав, но верхние ряды труднее сравнивать между категориями, чем в группированных столбцах.
new Chart(ctx, {
type: 'bar',
data: {
labels: ['A', 'B', 'C'],
datasets: [
{ label: 'Men', data: [20, 35, 30], backgroundColor: '#36A2EB' },
{ label: 'Women', data: [25, 32, 34], backgroundColor: '#FF6384' }
]
},
options: {
scales: {
x: { stacked: true },
y: { stacked: true, beginAtZero: true }
}
}
});Стилизация столбцов
borderRadius скругляет углы столбцов (одно число — все углы; объект вида {topLeft:8} — конкретные). borderSkipped по умолчанию 'start' и опускает одну сторону — задайте false, чтобы рисовать все четыре. barPercentage и categoryPercentage вместе управляют толщиной столбцов и промежутками.