插件(Plugins)

插件是自定义或更改图表默认行为的最有效方式。它们已经在2.1.0 版本（仅限于全局插件）中引入，并且在2.5.0 版本（每个图表插件和选项）中进行了扩展。

使用插件

插件可以在图表实例之间共享：

var plugin = {
    /* plugin implementation */
};

// chart1 and chart2 use "plugin"
var chart1 = new Chart(ctx, {
    plugins: [plugin]
});

var chart2 = new Chart(ctx, {
    plugins: [plugin]
});

// chart3 doesn't use "plugin"
var chart3 = new Chart(ctx, {});

插件也可以直接在图表插件配置（即内联插件）中定义：

var chart = new Chart(ctx, {
    plugins: [
        {
            beforeInit: function(chart, options) {
                //..
            }
        }
    ]
});

但是，当需要自定义选项适用于多个图表时，这种方法并不理想。

全局插件

插件可以在全局范围内注册，应用于所有图表（即全局插件）：

Chart.plugins.register({
    // plugin implementation
});

注意: inline 插件不能全局注册

配置

插件 ID

插件必须定义一个唯一的 ID 以便可配置。

该 id 应该遵循npm 包名称约定：

不能以点或下划线开头
不能包含任何非网址安全的字符
不能包含大写字母
简短并合理的描述

如果打算公开发布一个插件，你可能要检查registry，看看该名字的插件是否已经存在。需要注意的是，在这种情况下，包名称应以 chartjs-plugin-为前缀，以显示在 Chart.js 插件注册表中。

插件选项

插件选项位于options.plugins配置下，并由插件 ID：options.plugins.{plugin-id}作为作用域。

var chart = new Chart(ctx, {
    config: {
        foo: { ... },           // chart 'foo' option
        plugins: {
            p1: {
                foo: { ... },   // p1 plugin 'foo' option
                bar: { ... }
            },
            p2: {
                foo: { ... },   // p2 plugin 'foo' option
                bla: { ... }
            }
        }
    }
});

禁用插件

要为特定图表禁用全局插件，插件选项必须设置为false：

Chart.plugins.register({
    id: "p1"
    // ...
});

var chart = new Chart(ctx, {
    config: {
        plugins: {
            p1: false // disable plugin 'p1' for this instance
        }
    }
});

插件核心 API

可用钩子 (从 2.6 版本开始):

beforeInit
afterInit
beforeUpdate (cancellable)
afterUpdate
beforeLayout (cancellable)
afterLayout
beforeDatasetsUpdate (cancellable)
afterDatasetsUpdate
beforeRender (cancellable)
beforeDatasetUpdate (cancellable)
afterDatasetUpdate
beforeRender (cancellable)
afterRender
beforeDraw (cancellable)
afterDraw
beforeDatasetsDraw (cancellable)
afterDatasetsDraw
beforeEvent (cancellable)
beforeDatasetDraw (cancellable)
afterDatasetDraw
beforeEvent (cancellable)
afterEvent
resize
destroy

插件