鸿蒙HarmonyOS实战-ArkUI事件（单一手势）_arkui如何实现长按

先自我介绍一下，小编浙江大学毕业，去过华为、字节跳动等大厂，目前阿里P7

深知大多数程序员，想要提升技能，往往是自己摸索成长，但自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年最新HarmonyOS鸿蒙全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，涵盖了95%以上鸿蒙开发知识点，真正体系化！

由于文件比较多，这里只是将部分目录截图出来，全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频，并且后续会持续更新

如果你需要这些资料，可以添加V获取：vip204888 （备注鸿蒙）

正文

| — | — | — | — | — | — |
| fingers | 整数 | 触发长按手势所需的最少手指数量 | 1 | 10 | 1 |
| repeat | 布尔 | 是否连续触发事件回调 | - | - | false |
| duration | 整数 | 触发长按所需的最短时间 | - | - | 500 |

案例：

// xxx.ets
@Entry
@Component
struct Index {
@State count: number = 0;

build() {
Column() {
Text(‘LongPress OnAction:’ + this.count).fontSize(28)
.gesture(
// 绑定可以重复触发的LongPressGesture
LongPressGesture({ repeat: true })
.onAction((event: GestureEvent) => {
if (event.repeat) {
this.count++;
}
})
.onActionEnd(() => {
this.count = 0;
})
)
}
.height(200)
.width(250)
.padding(20)
.border({ width: 3 })
.margin(30)
}
}

3.拖动手势（PanGesture）

拖动手势（PanGesture）是一种用于在移动设备上识别用户手指拖动操作的手势。通过拖动手势，用户可以在屏幕上拖动某个对象，例如移动一个图像、滚动一个列表或调整一个视图的位置。

拖动手势通常包括以下几个基本元素：

• 起始点（起始位置）：用户触摸屏幕的初始位置。
• 移动点（当前位置）：用户在屏幕上滑动手指时的当前位置。
• 移动向量：起始点和移动点之间的向量，表示手指移动的方向和距离。

拖动手势可以用于许多应用场景，例如：

• 拖动和移动元素：用户可以在屏幕上拖动图像、视图或其他元素，以实现移动、重新排列或调整它们的位置。
• 滚动视图内容：用户可以在滚动视图中使用拖动手势来滚动内容，以浏览长列表或视图。
• 双指拖动：有些应用程序支持双指拖动手势，通过同时滑动两个手指来实现某些特殊操作，例如旋转或缩放图像。

在移动设备的开发中，开发人员可以使用各种框架和技术，来实现拖动手势的识别和处理。通过捕捉拖动手势并处理它们，开发人员可以为用户提供更流畅、直观的界面交互体验。

接口说明：

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

参数	是否必选	描述
fingers	非必选	声明触发拖动手势所需要的最少手指数量，最小值为1，最大值为10，默认值为1
direction	非必选	声明触发拖动的手势方向，支持逻辑与（&）和逻辑或（
distance	非必选	声明触发拖动的最小拖动识别距离，单位为vp，默认值为5

案例：

// xxx.ets
@Entry
@Component
struct Index {
@State offsetX: number = 0;
@State offsetY: number = 0;
@State positionX: number = 0;
@State positionY: number = 0;

build() {
Column() {
Text('PanGesture Offset:\nX: ’ + this.offsetX + ‘\n’ + 'Y: ’ + this.offsetY)
.fontSize(28)
.height(200)
.width(300)
.padding(20)
.border({ width: 3 })
// 在组件上绑定布局位置信息
.translate({ x: this.offsetX, y: this.offsetY, z: 0 })
.gesture(
// 绑定拖动手势
PanGesture()
.onActionStart((event: GestureEvent) => {
console.info(‘Pan start’);
})
// 当触发拖动手势时，根据回调函数修改组件的布局位置信息
.onActionUpdate((event: GestureEvent) => {
this.offsetX = this.positionX + event.offsetX;
this.offsetY = this.positionY + event.offsetY;
})
.onActionEnd(() => {
this.positionX = this.offsetX;
this.positionY = this.offsetY;
})
)
}
.height(200)
.width(250)
}
}

4.捏合手势（PinchGesture）

捏合手势（PinchGesture）是一种手势操作，通常在触摸屏上使用。它涉及使用两个或更多的手指同时向内或向外移动，以缩小或放大屏幕上的内容。当手指向内移动时，被捏合的物体（如图片、网页等）将会被缩小；当手指向外移动时，被捏合的物体将会被放大。

捏合手势在现代移动设备中广泛应用，例如在智能手机和平板电脑上浏览照片、地图、网页等时经常使用捏合手势来实现缩放功能。此外，捏合手势也可以用于一些操作，例如在编辑应用程序中调整对象大小或在游戏中控制角色的动作。

接口说明：

PinchGesture(value?:{fingers?:number; distance?:number})

参数	描述	最小值	最大值	默认值
fingers	声明触发捏合手势所需要的最少手指数量	2	5	2
distance	声明触发捏合手势的最小距离			5vp

案例：

// xxx.ets
@Entry
@Component
struct Index {
@State scaleValue: number = 1;
@State pinchValue: number = 1;
@State pinchX: number = 0;
@State pinchY: number = 0;

build() {
Column() {
Column() {
Text(‘PinchGesture scale:\n’ + this.scaleValue)
Text(‘PinchGesture center:\n(’ + this.pinchX + ‘,’ + this.pinchY + ‘)’)
}
.height(200)
.width(300)
.border({ width: 3 })
.margin({ top: 100 })
// 在组件上绑定缩放比例，可以通过修改缩放比例来实现组件的缩小或者放大
.scale({ x: this.scaleValue, y: this.scaleValue, z: 1 })
.gesture(
// 在组件上绑定三指触发的捏合手势
PinchGesture({ fingers: 3 })
.onActionStart((event: GestureEvent) => {
console.info(‘Pinch start’);
})
// 当捏合手势触发时，可以通过回调函数获取缩放比例，从而修改组件的缩放比例
.onActionUpdate((event: GestureEvent) => {
this.scaleValue = this.pinchValue * event.scale;
this.pinchX = event.pinchCenterX;
this.pinchY = event.pinchCenterY;
})
.onActionEnd(() => {
this.pinchValue = this.scaleValue;
console.info(‘Pinch end’);
})
)
}
}
}

5.旋转手势（RotationGesture）

旋转手势（Rotation Gesture）是一种常见的手势识别方式，用于识别用户在触摸屏上进行旋转操作的手势。在移动设备上，旋转手势通常使用两个手指来执行旋转操作。

在旋转手势中，用户可以用两个手指按住屏幕上的对象，并围绕一个旋转中心点进行旋转动作。该手势可以用于各种应用场景，例如在地图应用中旋转地图方向，或在图片编辑应用中旋转图像。

当用户进行旋转手势时，系统会根据手指的移动轨迹和角度变化来计算旋转角度，并将其作为旋转手势的输入。开发者可以通过手势识别库或框架来监听和处理旋转手势，以实现相应的功能。

接口说明：

RotationGesture(value?:{fingers?:number; angle?:number})

参数	类型	描述	默认值
fingers	int	触发旋转手势所需的最少手指数量，最小值为2，最大值为5	2
angle	float	触发旋转手势的最小改变度数，单位为deg	1

案例：

// xxx.ets
@Entry
@Component
struct Index {
@State angle: number = 0;
@State rotateValue: number = 0;

build() {
Column() {
Text(‘RotationGesture angle:’ + this.angle).fontSize(28)
// 在组件上绑定旋转布局，可以通过修改旋转角度来实现组件的旋转
.rotate({ angle: this.angle })
.gesture(
RotationGesture()
.onActionStart((event: GestureEvent) => {
console.info(‘RotationGesture is onActionStart’);
})
// 当旋转手势生效时，通过旋转手势的回调函数获取旋转角度，从而修改组件的旋转角度
.onActionUpdate((event: GestureEvent) => {
this.angle = this.rotateValue + event.angle;
console.info(‘RotationGesture is onActionEnd’);
})
// 当旋转结束抬手时，固定组件在旋转结束时的角度
.onActionEnd(() => {
this.rotateValue = this.angle;
console.info(‘RotationGesture is onActionEnd’);
})
.onActionCancel(() => {
console.info(‘RotationGesture is onActionCancel’);
})
)
}
.height(200)
.width(250)
}
}

6.滑动手势（SwipeGesture）

滑动手势（SwipeGesture）是一种用户界面交互行为，通过在触摸屏上进行手指滑动操作来执行特定的动作或触发特定的事件。滑动手势通常用于移动应用程序中的页面导航、图片浏览、删除操作等场景。

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化的资料的朋友，可以添加V获取：vip204888 （备注鸿蒙）

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

，通过在触摸屏上进行手指滑动操作来执行特定的动作或触发特定的事件。滑动手势通常用于移动应用程序中的页面导航、图片浏览、删除操作等场景。

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化的资料的朋友，可以添加V获取：vip204888 （备注鸿蒙）
[外链图片转存中…(img-pWtnmti2-1713213768325)]

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！