Charts
Bootstrap charts
Note: This documentation is for an older version of Bootstrap (v.4). A
newer version is available for Bootstrap 5. We recommend migrating to the latest version of our product - Material Design for
Bootstrap 5.
Go to docs v.5
Bootstrap charts are graphical representations of data. They are responsive and easy to customize.
At your disposal are eight types of charts with multiple options for customization.
If you need additional help, please read our tutorial about creating and customizing charts from scratch.
Basic usage
It's easy to get started with MDB charts.
Step 1 - add the
<canvas> element to your document:
<canvas id="myChart" style="max-width: 500px;"></canvas>
Step 2 - at the bottom of the document, below the
mdb.js script, place the code with chart settings, such as:
var ctx = document.getElementById("myChart").getContext('2d');
var myChart = new Chart(ctx, {
type: 'bar',
data: {
labels: ["Red", "Blue", "Yellow", "Green", "Purple", "Orange"],
datasets: [{
label: '# of Votes',
data: [12, 19, 3, 5, 2, 3],
backgroundColor: [
'rgba(255, 99, 132, 0.2)',
'rgba(54, 162, 235, 0.2)',
'rgba(255, 206, 86, 0.2)',
'rgba(75, 192, 192, 0.2)',
'rgba(153, 102, 255, 0.2)',
'rgba(255, 159, 64, 0.2)'
],
borderColor: [
'rgba(255,99,132,1)',
'rgba(54, 162, 235, 1)',
'rgba(255, 206, 86, 1)',
'rgba(75, 192, 192, 1)',
'rgba(153, 102, 255, 1)',
'rgba(255, 159, 64, 1)'
],
borderWidth: 1
}]
},
options: {
scales: {
yAxes: [{
ticks: {
beginAtZero: true
}
}]
}
}
});
Note: You don't need to set a width via css. You can place the
<canvas> element within a grid column. Charts are responsive, so they will adjust the width to
the size of the parent.
<div class="col-md-5">
<canvas id="myChart"></canvas>
</div>
Line chart
A line chart is a way of plotting data points on a line. Often, it is used to show trend data, or the comparison of two data sets.
<canvas id="lineChart"></canvas>
//line
var ctxL = document.getElementById("lineChart").getContext('2d');
var myLineChart = new Chart(ctxL, {
type: 'line',
data: {
labels: ["January", "February", "March", "April", "May", "June", "July"],
datasets: [{
label: "My First dataset",
data: [65, 59, 80, 81, 56, 55, 40],
backgroundColor: [
'rgba(105, 0, 132, .2)',
],
borderColor: [
'rgba(200, 99, 132, .7)',
],
borderWidth: 2
},
{
label: "My Second dataset",
data: [28, 48, 40, 19, 86, 27, 90],
backgroundColor: [
'rgba(0, 137, 132, .2)',
],
borderColor: [
'rgba(0, 10, 130, .7)',
],
borderWidth: 2
}
]
},
options: {
responsive: true
}
});
Radar chart
A radar chart is a way of showing multiple data points and the variation between them. They are often useful for comparing the points of two or more different data sets.
<canvas id="radarChart"></canvas>
//radar
var ctxR = document.getElementById("radarChart").getContext('2d');
var myRadarChart = new Chart(ctxR, {
type: 'radar',
data: {
labels: ["Eating", "Drinking", "Sleeping", "Designing", "Coding", "Cycling", "Running"],
datasets: [{
label: "My First dataset",
data: [65, 59, 90, 81, 56, 55, 40],
backgroundColor: [
'rgba(105, 0, 132, .2)',
],
borderColor: [
'rgba(200, 99, 132, .7)',
],
borderWidth: 2
},
{
label: "My Second dataset",
data: [28, 48, 40, 19, 96, 27, 100],
backgroundColor: [
'rgba(0, 250, 220, .2)',
],
borderColor: [
'rgba(0, 213, 132, .7)',
],
borderWidth: 2
}
]
},
options: {
responsive: true
}
});
Bar chart
A bar chart provides a way of showing data values represented as vertical bars. It is sometimes used to show trend data, and the comparison of multiple data sets side by side.
<canvas id="barChart"></canvas>
//bar
var ctxB = document.getElementById("barChart").getContext('2d');
var myBarChart = new Chart(ctxB, {
type: 'bar',
data: {
labels: ["Red", "Blue", "Yellow", "Green", "Purple", "Orange"],
datasets: [{
label: '# of Votes',
data: [12, 19, 3, 5, 2, 3],
backgroundColor: [
'rgba(255, 99, 132, 0.2)',
'rgba(54, 162, 235, 0.2)',
'rgba(255, 206, 86, 0.2)',
'rgba(75, 192, 192, 0.2)',
'rgba(153, 102, 255, 0.2)',
'rgba(255, 159, 64, 0.2)'
],
borderColor: [
'rgba(255,99,132,1)',
'rgba(54, 162, 235, 1)',
'rgba(255, 206, 86, 1)',
'rgba(75, 192, 192, 1)',
'rgba(153, 102, 255, 1)',
'rgba(255, 159, 64, 1)'
],
borderWidth: 1
}]
},
options: {
scales: {
yAxes: [{
ticks: {
beginAtZero: true
}
}]
}
}
});
Horizontal Bar Chart
Use a horizontal bar chart when you're presenting a long list of results that would become crowded if displayed vertically. Options specified on the x-axis in a bar chart, are applied to the y-axis in a horizontal bar chart.
<canvas id="horizontalBar"></canvas>
new Chart(document.getElementById("horizontalBar"), {
"type": "horizontalBar",
"data": {
"labels": ["Red", "Orange", "Yellow", "Green", "Blue", "Purple", "Grey"],
"datasets": [{
"label": "My First Dataset",
"data": [22, 33, 55, 12, 86, 23, 14],
"fill": false,
"backgroundColor": ["rgba(255, 99, 132, 0.2)", "rgba(255, 159, 64, 0.2)",
"rgba(255, 205, 86, 0.2)", "rgba(75, 192, 192, 0.2)", "rgba(54, 162, 235, 0.2)",
"rgba(153, 102, 255, 0.2)", "rgba(201, 203, 207, 0.2)"
],
"borderColor": ["rgb(255, 99, 132)", "rgb(255, 159, 64)", "rgb(255, 205, 86)",
"rgb(75, 192, 192)", "rgb(54, 162, 235)", "rgb(153, 102, 255)", "rgb(201, 203, 207)"
],
"borderWidth": 1
}]
},
"options": {
"scales": {
"xAxes": [{
"ticks": {
"beginAtZero": true
}
}]
}
}
});
Polar Area Chart
Polar area charts segment has the same angle - the radius of the segment differs depending on the value.
<canvas id="polarChart"></canvas>
//polar
var ctxPA = document.getElementById("polarChart").getContext('2d');
var myPolarChart = new Chart(ctxPA, {
type: 'polarArea',
data: {
labels: ["Red", "Green", "Yellow", "Grey", "Dark Grey"],
datasets: [{
data: [300, 50, 100, 40, 120],
backgroundColor: ["rgba(219, 0, 0, 0.1)", "rgba(0, 165, 2, 0.1)", "rgba(255, 195, 15, 0.2)",
"rgba(55, 59, 66, 0.1)", "rgba(0, 0, 0, 0.3)"
],
hoverBackgroundColor: ["rgba(219, 0, 0, 0.2)", "rgba(0, 165, 2, 0.2)",
"rgba(255, 195, 15, 0.3)", "rgba(55, 59, 66, 0.1)", "rgba(0, 0, 0, 0.4)"
]
}]
},
options: {
responsive: true
}
});
Pie Chart
A pie chart is a circular chart divided into sectors, each sector (and consequently its central angle and area), is proportional to the quantity it represents. Together, the sectors create a full disk.
<canvas id="pieChart"></canvas>
//pie
var ctxP = document.getElementById("pieChart").getContext('2d');
var myPieChart = new Chart(ctxP, {
type: 'pie',
data: {
labels: ["Red", "Green", "Yellow", "Grey", "Dark Grey"],
datasets: [{
data: [300, 50, 100, 40, 120],
backgroundColor: ["#F7464A", "#46BFBD", "#FDB45C", "#949FB1", "#4D5360"],
hoverBackgroundColor: ["#FF5A5E", "#5AD3D1", "#FFC870", "#A8B3C5", "#616774"]
}]
},
options: {
responsive: true
}
});
Doughnut Chart
The doughnut chart allows a number of properties to be specified for each dataset. These are used to set display properties for a specific dataset. For example, the colors of the dataset's arcs are generally set this way.
<canvas id="doughnutChart"></canvas>
//doughnut
var ctxD = document.getElementById("doughnutChart").getContext('2d');
var myLineChart = new Chart(ctxD, {
type: 'doughnut',
data: {
labels: ["Red", "Green", "Yellow", "Grey", "Dark Grey"],
datasets: [{
data: [300, 50, 100, 40, 120],
backgroundColor: ["#F7464A", "#46BFBD", "#FDB45C", "#949FB1", "#4D5360"],
hoverBackgroundColor: ["#FF5A5E", "#5AD3D1", "#FFC870", "#A8B3C5", "#616774"]
}]
},
options: {
responsive: true
}
});
Bubble Chart
<canvas id="bubbleChart"></canvas>
var ctxBc = document.getElementById('bubbleChart').getContext('2d');
var bubbleChart = new Chart(ctxBc, {
type: 'bubble',
data: {
datasets: [{
label: 'John',
data: [{
x: 3,
y: 7,
r: 10
}],
backgroundColor: "#ff6384",
hoverBackgroundColor: "#ff6384"
}, {
label: 'Peter',
data: [{
x: 5,
y: 7,
r: 10
}],
backgroundColor: "#44e4ee",
hoverBackgroundColor: "#44e4ee"
}, {
label: 'Donald',
data: [{
x: 7,
y: 7,
r: 10
}],
backgroundColor: "#62088A",
hoverBackgroundColor: "#62088A"
}]
}
})
Scatter Chart
<canvas id="scatterChart"></canvas>
var ctxSc = document.getElementById('scatterChart').getContext('2d');
var scatterData = {
datasets: [{
borderColor: 'rgba(99,0,125, .2)',
backgroundColor: 'rgba(99,0,125, .5)',
label: 'V(node2)',
data: [{
x: 1,
y: -1.711e-2,
}, {
x: 1.26,
y: -2.708e-2,
}, {
x: 1.58,
y: -4.285e-2,
}, {
x: 2.0,
y: -6.772e-2,
}, {
x: 2.51,
y: -1.068e-1,
}, {
x: 3.16,
y: -1.681e-1,
}, {
x: 3.98,
y: -2.635e-1,
}, {
x: 5.01,
y: -4.106e-1,
}, {
x: 6.31,
y: -6.339e-1,
}, {
x: 7.94,
y: -9.659e-1,
}, {
x: 10.00,
y: -1.445,
}, {
x: 12.6,
y: -2.110,
}, {
x: 15.8,
y: -2.992,
}, {
x: 20.0,
y: -4.102,
}, {
x: 25.1,
y: -5.429,
}, {
x: 31.6,
y: -6.944,
}, {
x: 39.8,
y: -8.607,
}, {
x: 50.1,
y: -1.038e1,
}, {
x: 63.1,
y: -1.223e1,
}, {
x: 79.4,
y: -1.413e1,
}, {
x: 100.00,
y: -1.607e1,
}, {
x: 126,
y: -1.803e1,
}, {
x: 158,
y: -2e1,
}, {
x: 200,
y: -2.199e1,
}, {
x: 251,
y: -2.398e1,
}, {
x: 316,
y: -2.597e1,
}, {
x: 398,
y: -2.797e1,
}, {
x: 501,
y: -2.996e1,
}, {
x: 631,
y: -3.196e1,
}, {
x: 794,
y: -3.396e1,
}, {
x: 1000,
y: -3.596e1,
}]
}]
}
var config1 = new Chart.Scatter(ctxSc, {
data: scatterData,
options: {
title: {
display: true,
text: 'Scatter Chart - Logarithmic X-Axis'
},
scales: {
xAxes: [{
type: 'logarithmic',
position: 'bottom',
ticks: {
userCallback: function (tick) {
var remain = tick / (Math.pow(10, Math.floor(Chart.helpers.log10(tick))));
if (remain === 1 || remain === 2 || remain === 5) {
return tick.toString() + 'Hz';
}
return '';
},
},
scaleLabel: {
labelString: 'Frequency',
display: true,
}
}],
yAxes: [{
type: 'linear',
ticks: {
userCallback: function (tick) {
return tick.toString() + 'dB';
}
},
scaleLabel: {
labelString: 'Voltage',
display: true
}
}]
}
}
});
Chart with labels
<canvas id="labelChart"></canvas>
var ctxP = document.getElementById("labelChart").getContext('2d');
var myPieChart = new Chart(ctxP, {
plugins: [ChartDataLabels],
type: 'pie',
data: {
labels: ["Red", "Green", "Yellow", "Grey", "Dark Grey"],
datasets: [{
data: [210, 130, 120, 160, 120],
backgroundColor: ["#F7464A", "#46BFBD", "#FDB45C", "#949FB1", "#4D5360"],
hoverBackgroundColor: ["#FF5A5E", "#5AD3D1", "#FFC870", "#A8B3C5", "#616774"]
}]
},
options: {
responsive: true,
legend: {
position: 'right',
labels: {
padding: 20,
boxWidth: 10
}
},
plugins: {
datalabels: {
formatter: (value, ctx) => {
let sum = 0;
let dataArr = ctx.chart.data.datasets[0].data;
dataArr.map(data => {
sum += data;
});
let percentage = (value * 100 / sum).toFixed(2) + "%";
return percentage;
},
color: 'white',
labels: {
title: {
font: {
size: '16'
}
}
}
}
}
}
});
Options
Charts have plenty of options that can you use.
Line options
The line chart allows a number of properties to be specified for each dataset. These are used to set display properties for a specific dataset. For example, the colour of a line is generally set this way.
All point* properties can be specified as an array. If these are set to an array value, the first value applies to the first point, the second value to the second point, and so on.
| Name | Type | Description |
|---|---|---|
| label | String | The label for the dataset that appears in the legend and tooltips. |
| xAxisID | String | The ID of the x-axis to plot this dataset on. If not specified, this defaults to the ID of the first found x-axis |
| yAxisID | String | The ID of the y-axis to plot this dataset on. If not specified, this defaults to the ID of the first found y-axis. |
| backgroundColor | Color | The fill color under the line. |
| borderColor | Color | The color of the line. |
| borderWidth | Number | The width of the line in pixels. |
| borderDash | Number[] | The length and spacing of dashes. |
| borderDashOffset | Number | Offset for line dashes. |
| borderCapStyle | String | Cap style of the line. |
| borderJoinStyle | String | Line joint style. |
| cubicInterpolationMode | String | The algorithm used to interpolate a smooth curve from the discrete data points. |
| fill | Boolean/String | How to fill the area under the line. |
| lineTension | Number | Bezier curve tension of the line. Set to 0 to draw straight lines. This option is ignored if monotone cubic interpolation is used. |
| pointBackgroundColor | Color/Color[] | The fill color for points. |
| pointBorderColor | Color/Color[] | The border color for points. |
| pointBorderWidth | Number/Number[] | The width of the point border in pixels. |
| pointRadius | Number/Number[] | The radius of the point shape. If set to 0, the point is not rendered. |
| pointStyle | String/String[]/Image/Image[] | Style of the point. |
| pointRotation | Number/Number[] | The rotation of the point in degrees. |
| pointHitRadius | Number/Number[] | The pixel size of the non-displayed point that reacts to mouse events. |
| pointHoverBackgroundColor | Color/Color[] | Point background color when hovered. |
| pointHoverBorderColor | Color/Color[] | Point border color when hovered. |
| pointHoverBorderWidth | Number/Number[] | The border width of a point when hovered over. |
| pointHoverRadius | Number/Number[] | The radius of the point when hovered over. |
| showLine | Boolean | If false, the line is not drawn for this dataset. |
| spanGaps | Boolean | If true, lines will be drawn between points with no or null data. If false, points with NaN data will create a break in the line |
| steppedLine | Boolean/String | If the line is shown as a stepped line. |
Bar options
The bar chart allows a number of properties to be specified for each dataset. These are used to set display properties for a specific dataset. For example, the colour of the bars is generally set this way.
Some properties can be specified as an array. If these are set to an array value, the first value applies to the first bar, the second value to the second bar, and so on.
| Name | Type | Description |
|---|---|---|
| label | String | The label for the dataset which appears in the legend and tooltips. |
| xAxisID | String | The ID of the x axis to plot this dataset on. If not specified, this defaults to the ID of the first found x axis |
| yAxisID | String | The ID of the y axis to plot this dataset on. If not specified, this defaults to the ID of the first found y axis. |
| backgroundColor | Color/Color[] | The fill color of the bar. |
| borderColor | Color/Color[] | The color of the bar border. |
| borderWidth | Number/Number[] | The stroke width of the bar in pixels. |
| borderSkipped | String | Which edge to skip drawing the border for. |
| hoverBackgroundColor | Color/Color[] | The fill colour of the bars when hovered. |
| hoverBorderColor | Color/Color[] | The stroke colour of the bars when hovered. |
| hoverBorderWidth | Number/Number[] | The stroke width of the bars when hovered. |
Radar options
The radar chart allows a number of properties to be specified for each dataset. These are used to set display properties for a specific dataset. For example, the colour of a line is generally set this way.
All point* properties can be specified as an array. If these are set to an array value, the first value applies to the first point, the second value to the second point, and so on.
| Name | Type | Description |
|---|---|---|
| label | String | The label for the dataset which appears in the legend and tooltips. |
| backgroundColor | Color | The fill color under the line. |
| borderColor | Color | The color of the line. |
| borderWidth | Number | The width of the line in pixels. |
| borderDash | Number[] | Length and spacing of dashes. S |
| borderDashOffset | Number | Offset for line dashes. |
| borderCapStyle | String | Cap style of the line |
| borderJoinStyle | String | Line joint style |
| fill | Boolean/String | How to fill the area under the line. |
| lineTension | Number | Bezier curve tension of the line. Set to 0 to draw straightlines. |
| pointBackgroundColor | Color/Color[] | The fill color for points. |
| pointBorderColor | Color/Color[] | The border color for points. |
| pointBorderWidth | Number/Number[] | The width of the point border in pixels. |
| pointRadius | Number/Number[] | TThe radius of the point shape. If set to 0, the point is not rendered. |
| pointRotation | Number/Number[] | The rotation of the point in degrees. |
| pointStyle | String/String[]/Image/Image[] | Style of the point. |
| pointHitRadius | Number/Number[] | The pixel size of the non-displayed point that reacts to mouse events. |
| pointHoverBackgroundColor | Color/Color[] | Point background color when hovered. |
| pointHoverBorderColor | Color/Color[] | Point border color when hovered. |
| pointHoverBorderWidth | Number/Number[] | Border width of point when hovered. |
| pointHoverRadius | Number/Number[] | The radius of the point when hovered. |
Doughnut and Pie options
| Name | Type | Description |
|---|---|---|
| backgroundColor | Color[] | The fill color of the arcs in the dataset. |
| borderColor | Color[] | The border color of the arcs in the dataset. |
| borderWidth | Number[] | The border width of the arcs in the dataset. |
| hoverBackgroundColor | Color[] | The fill colour of the arcs when hovered. |
| hoverBorderColor | Color[] | The stroke colour of the arcs when hovered. |
| hoverBorderWidth | Number[] | The stroke width of the arcs when hovered. |
Legend
Charts displays data about the dataset that are appering on the chart.
| Name | Type | Default | Description |
|---|---|---|---|
| display | Boolean | true | showing legend |
| position | string | 'top' | Position of the legend. |
| fullWidth | Boolean | true | Marks that this box should take the full width of the canvas (pushing down other boxes). This is unlikely to need to be changed in day-to-day use. |
| onClick | Function |
A callback that is called when a click event is registered on a label item |
|
| onHover | Function |
A callback that is called when a 'mousemove' event is registered on top of a label item |
|
| reverse | Boolean | false |
Legend will show datasets in reverse order. |
| labels | Object |
See documentation about labels here. |
Legend Label Configuration
The legend label configuration is nested below the legend configuration using the labels
key.
| Name | Type | Default | Description |
|---|---|---|---|
| boxWidth | Number | 40 | width of coloured box |
| fontSize | Number | 12 | font size of text |
| fontStyle | String | 'normal' | font style of text |
| fontColor | Color | '#666' |
Color of text |
| fontFamily | String | "Roboto" |
Font family of legend text. |
| padding | Number | 10 |
Padding between rows of colored boxes. . |
| generateLabels | Function |
Generates legend items for each thing in the legend. Default implementation returns the text + styling for the color box. |
|
| filter | Function | null |
Filters legend items out of the legend. Receives 2 parameters, a Legend Item and the chart data. |
| usePointStyle | Boolean | false |
Label style will match corresponding point style (size is based on fontSize, boxWidth is not used in this case). |
| backgroundColor | Style/Null | Null |
Background color of datalabels. . |
Animation
Charts animates out of the box. A number of options are provided to configure how the animiaton looks and how long it takes.
| Name | Type | Default | Description |
|---|---|---|---|
| duration | Number | 1000 | The number of milliseconds an animation takes |
| easing | String | easeOutQuart | Easing function to use. |
| onProgress | Function | null | Callback called at the end of an animation. |
| onComplete | Function | null |
Callback called on each step of an animation. |
Available options of easing
-
linear -
easeInQuad -
easeOutQuad -
easeInOutQuad -
easeInCubic -
easeOutCubic -
easeInOutCubic -
easeInQuart -
easeOutQuart -
easeInOutQuart -
easeInQuint -
easeOutQuint -
easeInOutQuint -
easeInSine -
easeOutSine -
easeInOutSine -
easeInExpo -
easeOutExpo -
easeInOutExpo -
easeInCirc -
easeOutCirc -
easeInOutCirc -
easeInElastic -
easeOutElastic -
easeInOutElastic -
easeInBack -
easeOutBack -
easeInOutBack -
easeInBounce -
easeOutBounce -
easeInOutBounce