Plugin

F2 提供插件机制用于扩展图表的功能,该机制可以帮助用户在图表创建的各个阶段定制或更改图表的默认行为。

目前默认提供了 legend、guide、tooltip 以及动画(群组以及精细动画两个版本)这四种插件。

F2 在 Chart 类上注册一个静态属性 Chart.plugins, 使用发布-订阅模式,在 chart 的生命周期中通知注册的各个插件进行各自的操作。

目前开放的生命周期包括:

  • init chart 初始化结束后
  • beforeGeomDraw 绘制 geom 之前
  • afterGeomDraw 绘制 geom 之后
  • beforeCanvasDraw canvas draw 之前
  • clear 清空图表,移除 geom
  • clearInner 清空图层
  • repaint 重绘

如何自定义插件

插件的实现非常简单,只需要在需要的生命周期节点定义具体的行为即可,可参考: Guide 插件

  1. const plugin ={
  2. init(chart){
  3. // do something when initialize the chart
  4. }
  5. };

如何注册/使用插件

  • 全局注册 Chart.plugins.register(Pluign);
  1. const plugin1 ={/* plugin implementation */};
  2. const plugin2 ={/* plugin implementation */};
  3. // 全局注册插件 plugin1,所有创建的 chart 实例都默认注册上
  4. Chart.plugins.register(plugin1);
  5. // 全局注册多个插件
  6. Chart.plugins.register([ plugin1, plugin2 ]);
  • 在 chart 实例上注册
  1. const plugin1 ={/* plugin implementation */};
  2. const plugin2 ={/* plugin implementation */};
  3.  
  4. // chart1 use "plugin1"
  5. const chart1 =newChart({
  6. plugins: plugin1
  7. );
  8. // chart2 use "plugin2"
  9. const chart2 =newChart({
  10. plugins: plugin2
  11. );
  12. // chart3 doesn't use "plugin"
  13. const chart3 =newChart({});

注销插件

Chart.plugins.unregister(plugins) 注销 plugins

清除插件

Chart.plugins.clear() 清除插件

获取注册的所有插件

Chart.plugins.getAll() 获取注册的所有插件

现有插件

原文: https://antv.alipay.com/zh-cn/f2/3.x/api/plugin.html