GestureEvent手势事件中涉及的坐标之间的区别主要在于参考系的不同。由于参考系的不同,不同的坐标适用于不同的使用场景,具体如下表所示:
坐标 | 参考系 | 常见使用场景 |
|---|---|---|
offsetX / offsetY | 手势起点 | 计算滑动距离和方向 |
localX / localY | 当前组件元素原始区域左上角 | 组件内部交互,例如Canvas画布绘制 |
displayX / displayY | 物理屏幕左上角 | 全局手势,例如检测滑动手势是否靠近屏幕边缘 |
根据使用场景选择适合的坐标:
@Entry @Component struct EdgeGestureDemo { @State edgeTriggered: boolean = false; build() { Column() { Text(this.edgeTriggered ? '触发返回手势' : '从屏幕左边缘右滑') .fontSize(20) .margin(50); } .width('100%') .height('100%') .gesture( PanGesture() .onActionUpdate((event: GestureEvent) => { // 使用displayX检测屏幕边缘,其中数值30和60仅作示例,根据业务实际需要做出调整 if (event.fingerList[0].displayX < 60 && event.offsetX > 30) { // 从边缘滑动超过30vp this.edgeTriggered = true; } }) .onActionEnd(() => { this.edgeTriggered = false; }) ); } }