【鸿蒙实战开发】基于手势绑定的常见问题处理

最新推荐文章于 2025-07-15 18:00:00 发布

原创最新推荐文章于 2025-07-15 18:00:00 发布 · 529 阅读

6 ·

CC 4.0 BY-SA版权

文章标签：

#harmonyos #移动开发 #鸿蒙开发 #ArkTS #ArkUI #组件化

移动开发同时被 3 个专栏收录

704 篇文章

订阅专栏

鸿蒙开发

688 篇文章

订阅专栏

HarmonyOS

651 篇文章

订阅专栏

📚往期笔录记录🔖：

🔖鸿蒙（HarmonyOS）北向开发知识点记录~
🔖鸿蒙（OpenHarmony）南向开发保姆级知识点汇总~
🔖鸿蒙应用开发与鸿蒙系统开发哪个更有前景？
🔖嵌入式开发适不适合做鸿蒙南向开发？看完这篇你就了解了~
🔖对于大前端开发来说，转鸿蒙开发究竟是福还是祸？
🔖鸿蒙岗位需求突增！移动端、PC端、IoT到底该怎么选？
🔖记录一场鸿蒙开发岗位面试经历~
🔖持续更新中……

场景一：父子组件同时绑定手势的冲突处理

效果图

方案

在默认情况下，手势事件为非冒泡事件，当父子组件绑定相同的手势时，父子组件绑定的手势事件会发生竞争，最多只有一个组件的手势事件能够获得响应，默认子组件优先识别通过gesture绑定的手势。

当父组件使用priorityGesture绑定与子组件同类型的手势时，父组件优先识别通过priorityGesture绑定的手势，子组件的手势不会进行识别响应。
当父组件绑定了并行手势parallelGesture时，父子组件相同的手势事件都可以触发，实现类似冒泡效果（当前规格：当父组件和子组件同时绑定单击手势事件和双击手势事件时，父组件和子组件均只响应单击手势事件）。

核心代码


build() {

Column() {

Column() {

Text('TapGesture:' + this.priorityTestValue).fontSize(28)

.gesture(

TapGesture()

.onAction(() => {

this.priorityTestValue += '\n子组件响应'

}))

}

.height(300)

.width(250)

.padding(20)

.margin(20)

.border({ width: 3 })

// 设置为priorityGesture时，点击文本会忽略Text组件的TapGesture手势事件，优先识别父组件Column的TapGesture手势事件

.priorityGesture(

TapGesture()

.onAction((event?: GestureEvent) => {

this.priorityTestValue += '\n父组件响应'

}), GestureMask.IgnoreInternal)

Column() {

Text('TapGesture:' + this.parallelTestValue).fontSize(28)

.gesture(

TapGesture()

.onAction(() => {

this.parallelTestValue += '\n子组件响应'

}))

}

.height(300)

.width(250)

.padding(20)

.margin(20)

.border({ width: 3 })

// 设置为parallelGesture时，点击文本会同时触发子组件Text与父组件Column的TapGesture手势事件

.parallelGesture(

TapGesture()

.onAction((event?: GestureEvent) => {

this.parallelTestValue += '\n父组件响应'

}), GestureMask.Normal)

}

}

场景二：手势实现自定义组件滑动离手后的惯性滑动效果。

效果图

方案

通过GestureEvent中开放出来的的velocityX和velocityY分别对应当前手势的x轴方向速度和y轴方向速度，通过离手时的速度计算惯性滑动的距离，通过动画animateTo来模拟惯性滑动的效果。

核心代码

.gesture(

PanGesture(this.panOption)

.onActionStart((event?: GestureEvent) => {

console.info('Pan start')

})

.onActionUpdate((event?: GestureEvent) => {

if (event) {

this.vX = event.velocityX

this.vY = event.velocityY

this.offsetX = this.positionX + event.offsetX

this.offsetY = this.positionY + event.offsetY

}

})

.onActionEnd(() => {

animateTo({

duration: 1000,

curve: Curve.EaseOut,

iterations: 1,

playMode: PlayMode.Normal,

onFinish: () => {

console.info('play end')

}

}, () => {

// 滑动距离：s = Vo*t+(Vt-Vo)/t*t^2/2 = Vo*t+(Vt-Vo)*t/2 = Vo*t+Vt*t/2-Vo*t/2 = (Vo+Vt)*t/2

// Vo = Vx Vt = 0 当t=1时，

this.offsetX = this.vX / 2

this.offsetY = this.vY / 2

})

})

)

场景三：手势实现类似地图中搜索地址滑动效果

方案

使用bindSheet属性为组件绑定半模态页面，结合绑定并行手势事件parallelGesture，在手指上滑和下滑时分别进行手势的操作，修改半模态页面的高度值。

核心代码

手指上滑时：优先识别list组件自身滚动效果，当list滚动到临界值时，触发list组件的onReachEnd回调，在回调中修改自定义变量值；在并行手势parallelGesture的panGesture手势的onActionUpdate回调中，进行逻辑判断以及对半模态页面的高度进行动态赋值为原先高度加上手势偏移量。

    .onReachEnd(() => {

    this.reachEnd=true

    this.aaa=true

    this.reachStart=false

    console.log('onReachEnd', 'this.reachEnd:'+this.reachEnd,'this.reachStart:'+this.reachStart)

    })

    // list往上滑到头：识别手势，高度增加

    if(this.reachEnd){

    animateTo({

    duration: 2000,

    curve: Curve.EaseOut,

    iterations: 1,

    playMode: PlayMode.Normal,

    onFinish: () => {

    console.info('play end')

    }

    }, () => {

    this.sheetHeight=this.setSheetHeight-event.offsetY

    })

    if(event.offsetY>0){

    this.reachEnd=false

    console.log('this.reachEnd', this.reachEnd)

    }

    console.log('offsetY 往上滑',event.offsetY,event.offsetY)

    }

手指下滑时：优先识别List组件自身滚动效果，当List滚动到临界值时，触发List组件的onReachStart回调，在回调中修改自定义变量值；在并行手势parallelGesture的panGesture手势的onActionUpdate回调中，进行逻辑判断以及对半模态页面的高度进行动态赋值为原先高度减去手势偏移量。

    .onReachStart(() => {

    this.reachStart=true

    this.reachEnd=false

    console.log('onReachStart','this.reachEnd:'+this.reachEnd,'this.reachStart:'+this.reachStart)

    })

    // list往下滑到底，识别手势，高度减小

    if(this.reachStart){

    animateTo({

    duration: 2000,

    curve: Curve.EaseOut,

    iterations: 1,

    playMode: PlayMode.Normal,

    onFinish: () => {

    console.info('play end')

    }

    }, () => {

    this.sheetHeight=this.setSheetHeight-event.offsetY

    })

    if(event.offsetY<0){

    this.reachStart=false

    console.log('this.reachEnd', this.reachStart)

    }

    console.log('offsetY 往下滑',event.offsetY,this.reachStart)

    }