codecamp

触发拖动手势事件

用于触发拖动手势事件,滑动的最小距离为5vp时拖动手势识别成功。

说明

从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

接口

PanGesture(value?: { fingers?: number; direction?: PanDirection; distance?: number } | PanGestureOptions)

参数:

参数名称

参数类型

必填

参数描述

fingers

number

触发拖动的最少手指数,最小为1指, 最大取值为10指。

默认值:1

取值范围:[1,10]

说明:

当设置的值小于1或不设置时,会被转化为默认值。

direction

PanDirection

触发拖动的手势方向,此枚举值支持逻辑与(&)和逻辑或(|)运算。

默认值:PanDirection.All

distance

number

最小拖动识别距离,单位为vp。

默认值:5

说明:

Tabs组件滑动与该拖动手势事件同时存在时,可将distance值设为1,使拖动更灵敏,避免造成事件错乱。

当拖动距离的值小于等于0时,会被转化为默认值。

当设置拖动的距离超过当前窗口尺寸的值时,无法触发拖动。

PanDirection枚举说明

名称

描述

All

所有方向。

Horizontal

水平方向。

Vertical

竖直方向。

Left

向左拖动。

Right

向右拖动。

Up

向上拖动。

Down

向下拖动。

None

任何方向都不可触发拖动手势事件。

PanGestureOptions

通过PanGestureOptions对象接口可以动态修改滑动手势识别器的属性,从而避免通过状态变量修改属性(状态变量修改会导致UI刷新)。

PanGestureOptions(value?: { fingers?: number; direction?: PanDirection; distance?: number })

参数:

参数名称

参数类型

必填

参数描述

fingers

number

触发滑动的最少手指数,最小为1指, 最大取值为10指。

默认值:1

direction

PanDirection

设置滑动方向,此枚举值支持逻辑与(&)和逻辑或(|)运算。

默认值:All

distance

number

最小滑动识别距离,单位为vp。

默认值:5.0

说明:

Tabs组件滑动与该拖动手势事件同时存在时,可将distance值设为1,使拖动更灵敏,避免造成事件错乱。

接口

名称

功能描述

setDirection(value: PanDirection)

设置direction属性。

setDistance(value: number)

设置distance属性。

setFingers(value: number)

设置fingers属性。

事件

名称

功能描述

onActionStart(event: (event?: GestureEvent) => void)

Pan手势识别成功回调。

onActionUpdate(event: (event?: GestureEvent) => void)

Pan手势移动过程中回调。

onActionEnd(event: (event?: GestureEvent) => void)

Pan手势识别成功,手指抬起后触发回调。

onActionCancel(event: () => void)

Pan手势识别成功,接收到触摸取消事件触发回调。

示例

  1. // xxx.ets
  2. @Entry
  3. @Component
  4. struct PanGestureExample {
  5. @State offsetX: number = 0
  6. @State offsetY: number = 0
  7. @State positionX: number = 0
  8. @State positionY: number = 0
  9. private panOption: PanGestureOptions = new PanGestureOptions({ direction: PanDirection.Left | PanDirection.Right })
  10. build() {
  11. Column() {
  12. Column() {
  13. Text('PanGesture offset:\nX: ' + this.offsetX + '\n' + 'Y: ' + this.offsetY)
  14. }
  15. .height(200)
  16. .width(300)
  17. .padding(20)
  18. .border({ width: 3 })
  19. .margin(50)
  20. .translate({ x: this.offsetX, y: this.offsetY, z: 0 })// 以组件左上角为坐标原点进行移动
  21. // 左右拖动触发该手势事件
  22. .gesture(
  23. PanGesture(this.panOption)
  24. .onActionStart((event: GestureEvent) => {
  25. console.info('Pan start')
  26. })
  27. .onActionUpdate((event: GestureEvent) => {
  28. this.offsetX = this.positionX + event.offsetX
  29. this.offsetY = this.positionY + event.offsetY
  30. })
  31. .onActionEnd(() => {
  32. this.positionX = this.offsetX
  33. this.positionY = this.offsetY
  34. console.info('Pan end')
  35. })
  36. )
  37. Button('修改PanGesture触发条件')
  38. .onClick(() => {
  39. // 将PanGesture手势事件触发条件改为双指以任意方向拖动
  40. this.panOption.setDirection(PanDirection.All)
  41. this.panOption.setFingers(2)
  42. })
  43. }
  44. }
  45. }

示意图:

向左拖动:

点击按钮修改PanGesture触发条件,双指向左下方拖动:

触发长按手势事件
触发捏合手势
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

媒体组件

像素

枚举

类型

接口

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }