# scale-gesture-handler

> 相关文档: [手势系统](/miniprogram/dev/framework/runtime/skyline/gesture.md)

渲染框架支持情况：Skyline （使用最新 [Nightly](/miniprogram/dev/devtools/nightly.html) 工具调试）

## 功能描述

多指缩放时触发手势

## 通用属性


```json
[
  {
    "属性": "tag",
    "类型": "string",
    "默认值": "",
    "必填": "否",
    "说明": "声明手势协商时的组件标识"
  },
  {
    "属性": "worklet:ongesture",
    "类型": "eventhandler",
    "默认值": "",
    "必填": "否",
    "说明": "手势识别成功的回调",
    "子项": [
      {
        "eventhandler 回调参数": "state",
        "说明": "手势状态"
      },
      {
        "eventhandler 回调参数": "focalX",
        "说明": "中心点相对于全局的X坐标"
      },
      {
        "eventhandler 回调参数": "focalY",
        "说明": "中心点相对于全局的Y坐标"
      },
      {
        "eventhandler 回调参数": "focalDeltaX",
        "说明": "相对上一次，中心点在X轴方向移动的坐标"
      },
      {
        "eventhandler 回调参数": "focalDeltaY",
        "说明": "相对上一次，中心点在Y轴方向移动的坐标"
      },
      {
        "eventhandler 回调参数": "scale",
        "说明": "放大或缩小的比例"
      },
      {
        "eventhandler 回调参数": "horizontalScale",
        "说明": "scale的横向分量"
      },
      {
        "eventhandler 回调参数": "verticalScale",
        "说明": "scale的纵向分量"
      },
      {
        "eventhandler 回调参数": "rotation",
        "说明": "旋转角（单位：弧度）"
      },
      {
        "eventhandler 回调参数": "velocityX",
        "说明": "手指离开屏幕时的横向速度（pixel per second)"
      },
      {
        "eventhandler 回调参数": "velocityY",
        "说明": "手指离开屏幕时的纵向速度（pixel per second)"
      },
      {
        "eventhandler 回调参数": "pointerCount",
        "说明": "跟踪的手指数"
      }
    ]
  },
  {
    "属性": "worklet:should-response-on-move",
    "类型": "callback",
    "默认值": "",
    "必填": "否",
    "说明": "手指移动过程中手势是否响应"
  },
  {
    "属性": "worklet:should-accept-gesture",
    "类型": "callback",
    "默认值": "",
    "必填": "否",
    "说明": "手势是否应该被识别"
  },
  {
    "属性": "simultaneous-handlers",
    "类型": "Array.<string>",
    "默认值": "",
    "必填": "否",
    "说明": "声明可同时触发的手势节点"
  },
  {
    "属性": "native-view",
    "类型": "string",
    "默认值": "",
    "必填": "否",
    "说明": "代理的原生节点类型"
  }
]
```