Gesture

用于图表绑定图表上的手势事件。该方法会返回 gestureController。除了支持系统基础事件 touchstart、touchmove、touchend,还支持复杂的手势,基于手势库 hammerjs

image.png | left | 827x324

如何引入使用插件

Gesture 作为 F2 的插件,完整版不包含该手势插件,如果需要使用的话,需要先将该组件注册入 Chart 类或者 Chart 实例。

hammerjs 压缩文件大小 20k。 GZIP 后大小 7.3k。

  1. const F2 =require('@antv/f2/lib/core');
  2. constGesture=require('@antv/f2/lib/plugin/gesture');
  3. // 1.全局注册,也可以给 chart 的实例注册
  4. F2.Chart.plugins.register(Gesture);
  5. // 2.给具体的 chart 实例注册
  6. const chart =new F2.Chart({
  7. id:'canvas',
  8. plugins:Gesture
  9. });

API

  1. // 加载初始化手势插件
  2. chart.pluginGesture({
  3. gesture:{},
  4. hammerOptions:{},
  5. options:{},
  6. });

参数

  • gesture: Object
    需要绑定的手势事件,配置的属性为以事件名为 key 的回调方法。
  1. gesture:{
  2. touchstart(data,event){
  3. console.log('touchstart')
  4. },
  5. press(data,event){
  6. console.log('press')
  7. }
  8. }
  • 回调事件的第一个参数,data 是手势事件触发中心点坐标对应的图形数据点。
  • 回调事件的第二个参数,event 是手势事件对象。三个基础手势事件返回的是 touchEvent。hammer 手势返回的事件是 eventObject
  • hammerOptions: Object
    传递给 hammer 的参数配置。一般不需要配置。

  • options: Object
    手势插件的配置,配置如下

  1. options:{
  2. useCalculate:true,// 计算手势数据点,如果不需要可以关闭提高性能
  3. useOffset:false// 计算数据是否需要计算图表相对页面偏移的坐标。当图表宽度超出, scroll模式,计算位置需要加上滚动记录
  4. }

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