chartjs-plugin-colorschemes

     

Predefined color schemes for Chart.js

You can pick the perfect color combination for your charts from the predefined color schemes, which are based on popular tools such as ColorBrewer, Microsoft Office and Tableau.

This plugin requires Chart.js 4 or later.

Compatibility

| Chart.js | chartjs-plugin-colorschemes |
|-----------|-----------------------------|
| 4 | 0.6.1 |
| 3 | 0.5.4 |

Installation

You can download the latest version of chartjs-plugin-colorschemes from the GitHub releases.

To install via npm:

``bash
npm install hw-chartjs-plugin-colorschemes --save
`

To install via bower:

`bash
bower install hw-chartjs-plugin-colorschemes --save
`

To use CDN:

`html

`
`html

`

Usage

chartjs-plugin-colorschemes can be used with ES6 modules, plain JavaScript and module loaders.

Include Chart.js and chartjs-plugin-colorschemes.js to your page, and specify a color scheme as shown in the example below. You can pick a scheme from Color Chart.

`js
options: {
plugins: {
colorschemes: {
scheme: 'brewer.Paired12'
}
}
}
`

Every color scheme has a number at the end of its name, which indicates the number of that colors included in the scheme. If the number of the datasets is larger than it, the same colors will appear repeatedly. A color is not modified if it is specified by dataset options.

$3

Nothing else than importing the module should be enough.

`js
import 'chartjs-plugin-colorschemes';
`

If you want to reduce the size by only importing the plugin core and particular color schemes, see the example below.

`js
// import the plugin core
import 'chartjs-plugin-colorschemes/src/plugins/plugin.colorschemes';

// import a particular color scheme
import { Aspect6 } from 'chartjs-plugin-colorschemes/src/colorschemes/colorschemes.office';

// ...
options: {
plugins: {
colorschemes: {
scheme: Aspect6
}
}
}
//...
`

Tutorial

You can find a tutorial at nagix.github.io/chartjs-plugin-colorschemes.

Configuration

The plugin options can be changed at 2 different levels and with the following priority:

- per chart: options.plugins.colorschemes.*
- globally: Chart.defaults.global.plugins.colorschemes.*

All available options are listed below.

| Name | Type | Default | Description
| ---- | ---- | ------- | -----------
| fillAlpha | number | 0.5 | The transparency value for the line fill color. Must be a number between 0.0 (fully transparent) and 1.0 (no transparency).
| scheme | string|string[] | 'brewer.Paired12' | Color scheme name that is any of Color Chart. It also accepts an array of color strings, which is primarily for ES modules. more...
| reverse | boolean | false | If set to true, the order of the colors in the selected scheme is reversed.
| override | boolean | false | If set to true, the specified color scheme will override the existing color options. If false, it is only applied when no color setting exists. more...
| custom | function | undefined | A function that takes a copy of the color string array for scheme in order to extend the predefined scheme colors. more...

$3

By default, this plugin doesn't apply a color scheme if any color options are already specified. This may cause a problem if you are using a third party library such as ng-charts, which automatically applies default color settings. In that case, the existing color settings can be overridden by setting the override option to true.

$3

With the help of the custom-Function you can extend the predefined scheme colors. This function takes a copy of the current scheme and is expected to return an array with at least one element. See the example below.

`js
var customColorFunction = function(schemeColors) {
var myColors = ['#ff0000', '#00ff00', '#0000ff']; // define/generate own colors

// extend the color scheme with own colors
Array.prototype.push.apply(schemeColors, myColors);

return schemeColors; // optional: this is not needed if the array is modified in place
};

// ...
options: {
plugins: {
colorschemes: {
scheme: 'brewer.Paired12',
custom: customColorFunction
}
}
}
//...

`

$3

It is possible to build your custom colorscheme from scratch (without using the custom function) by simply defining the colors it contains. See example below.

`js
var myColors = ['red', 'green', 'blue', 'orange', 'black', 'yellow'];

// ...
options: {
plugins: {
colorschemes: {
scheme: myColors
}
}
}
//...

`

Building

You first need to install node dependencies (requires Node.js):

`bash
npm install
`

The following commands will then be available from the repository root:

`bash
gulp build # build dist files
gulp build --watch # build and watch for changes
gulp test # run all tests
gulp test --watch # run all tests and watch for changes
gulp test --coverage # run all tests and generate code coverage
gulp lint # perform code linting
gulp package # create an archive with dist files and samples
``

License

chartjs-plugin-colorschemes is available under the MIT license.