chartjs-plugin-autocolors

Automatic color generation for Chart.js

!GitHub Workflow Status

The generation is based on Janus Troelsen's answer at Stack Overflow.

This plugin requires Chart.js 3.0.0 or later. Could work with v2, but it is not supported.

NOTE the plugin does not automatically register.

Example

!Example chart

Installation

NPM:

``bash
npm i --save chartjs-plugin-autocolors
`

CDN:

`html

`

Usage

$3

ESM

`js
import autocolors from 'chartjs-plugin-autocolors';
`

CDN

`js
const autocolors = window['chartjs-plugin-autocolors'];
`

$3

All charts

`js
Chart.register(autocolors);
`

Single chart

`js
const chart = new Chart(ctx, {
// ...
plugins: [
autocolors
]
});
`

$3

If registered globally, it might be desirable to disable the autocolors for some charts

`js
const chart = new Chart(ctx, {
// ...
options: {
plugins: {
autocolors: {
enabled: false
}
}
}
});
`

$3

NOTE: 'dataset' mode does not work properly for Pie / Doughnut charts, so using 'data' mode with those charts is advised.

There are two modes, 'dataset' (default) 'data' and 'label'

- In 'dataset' mode, a new color is picked for each dataset.
- In 'data' mode, an array of colors, equivalent to the length of data is provided for each dataset.
- In 'label' mode, color is picked for each different dataset label.

`js
const chart = new Chart(ctx, {
// ...
options: {
plugins: {
autocolors: {
mode: 'data'
}
}
}
});
`

$3

A customize function can be provided to customize the generated colors.
The function is expected to return object containing background and border properties,
with values acceptable as colors by Chart.js.

`js
const lighten = (color, value) => Chart.helpers.color(color).lighten(value).rgbString();

const chart = new Chart(ctx, {
// ...
options: {
plugins: {
autocolors: {
customize(context) {
const colors = context.colors;
return {
background: lighten(colors.background, 0.5),
border: lighten(colors.border, 0.5)
};
}
}
}
}
});
`

$3

offset option can be used to offset the color generation by a number of colors.

`js
const chart = new Chart(ctx, {
// ...
options: {
plugins: {
autocolors: {
offset: 5
}
}
}
});
`

$3

Sometimes you might need to color multiple adjacent datasets with same color. The repeat option is for that use case.


`js
const chart = new Chart(ctx, {
// ...
options: {
plugins: {
autocolors: {
repeat: 2
}
}
}
});
`

Browser compatibility

This plugin uses a generator function, so it is not compatible with Internet Explorer.

License

chartjs-plugin-autocolors.js` is available under the MIT license.