Chart.js plugin to display labels on pie, doughnut and polar area chart.
npm install @murphybob/chartjs-plugin-labelsThis fork adds basic support for horizontal bar chart labels.
It is inspired by the fork at https://github.com/qubiack/chartjs-plugin-labels but somewhat less specific.
You can use this command to install:
npm install @murphybob/chartjs-plugin-labels
JavaScript
new Chart(ctx, {
type: type,
data: data,
options: {
plugins: {
labels: {
// render 'label', 'value', 'percentage', 'image' or custom function, default is 'percentage'
render: 'value', // precision for percentage, default is 0
precision: 0,
// identifies whether or not labels of value 0 are displayed, default is false
showZero: true,
// font size, default is defaultFontSize
fontSize: 12,
// font color, can be color array for each data or function for dynamic color, default is defaultFontColor
fontColor: '#fff',
// font style, default is defaultFontStyle
fontStyle: 'normal',
// font family, default is defaultFontFamily
fontFamily: "'Helvetica Neue', 'Helvetica', 'Arial', sans-serif",
// draw text shadows under labels, default is false
textShadow: true,
// text shadow intensity, default is 6
shadowBlur: 10,
// text shadow X offset, default is 3
shadowOffsetX: -5,
// text shadow Y offset, default is 3
shadowOffsetY: 5,
// text shadow color, default is 'rgba(0,0,0,0.3)'
shadowColor: 'rgba(255,0,0,0.75)',
// draw label in arc, default is false
// bar chart ignores this
arc: true,
// position to draw label, available value is 'default', 'border' and 'outside'
// bar chart ignores this
// default is 'default'
position: 'default',
// draw label even it's overlap, default is true
// bar chart ignores this
overlap: true,
// show the real calculated percentages from the values and don't apply the additional logic to fit the percentages to 100 in total, default is false
showActualPercentages: true,
// set images when
render is 'image'
images: [
{
src: 'image.png',
width: 16,
height: 16
}
], // add padding when position is
outside
// default is 2
outsidePadding: 4, // add margin of text when position is
or border
// also accepts a function which receives a callback payload (see below)
// default is 2
textMargin: 4,
// change horizontal alignment of label
// can be used for shifting text of unknown length inside or outside a horizontal bar
// also accepts a function which receives a callback payload (see below)
// default is "center"
textAlign: "right"
}
}
}
});// calbacks receive an object of the following shape
{
label: string,
value: number,
percentage: number,
dataset: ChartJs dataset,
index: number
}
// custom render
{
render: function (args) {
// args will be something like:
// { label: 'Label', value: 123, percentage: 50, index: 0, dataset: {...} }
return '$' + args.value;
// return object if it is image
// return { src: 'image.png', width: 16, height: 16 };
}
}
// dynamic fontColor
{
fontColor: function (args) {
// args will be something like:
// { index: 0, dataset: {...} }
return myColorTransfer(args.dataset.backgroundColor[index]);
}
}
Support multiple options, eg.
JavaScript
labels: [
{
render: 'label',
position: 'outside'
},
{
render: 'value'
}
]
`Global options
JavaScript
Chart.defaults.global.plugins.labels = {
// ...
};
`$3
If you use angular2-chartjs, you can import by this:
import { ChartModule } from 'angular2-chartjs';
import 'chartjs-plugin-labels';