触发滑动事件
用于触发滑动事件，滑动速度大于100vp/s时可识别成功。
说明
从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
接口
SwipeGesture(value?: { fingers?: number; direction?: SwipeDirection; speed?: number })
参数：
| 参数名称 | 参数类型 | 必填 | 参数描述 |
|---|---|---|---|
| fingers | number | 否 | 触发滑动的最少手指数，默认为1，最小为1指，最大为10指。 默认值：1 |
| direction | SwipeDirection | 否 | 触发滑动手势的滑动方向。 默认值：SwipeDirection.All |
| speed | number | 否 | 识别滑动的最小速度（默认为100VP/秒）。 默认值：100 |
SwipeDirection枚举说明
| 名称 | 描述 |
|---|---|
| All | 所有方向。 |
| Horizontal | 水平方向，手指滑动方向与x轴夹角小于45度时触发。 |
| Vertical | 竖直方向，手指滑动方向与y轴夹角小于45度时触发。 |
| None | 任何方向均不可触发。 |
示例
- // xxx.ets
- @Entry
- @Component
- struct SwipeGestureExample {
- @State rotateAngle: number = 0
- @State speed: number = 1
- build() {
- Column() {
- Column() {
- Text("SwipeGesture speed\n" + this.speed)
- Text("SwipeGesture angle\n" + this.rotateAngle)
- }
- .border({ width: 3 })
- .width(300)
- .height(200)
- .margin(100)
- .rotate({ angle: this.rotateAngle })
- // 单指竖直方向滑动时触发该事件
- .gesture(
- SwipeGesture({ direction: SwipeDirection.Vertical })
- .onAction((event: GestureEvent) => {
- this.speed = event.speed
- this.rotateAngle = event.angle
- })
- )
- }.width('100%')
- }
- }
