1. 滑动穿透到底是什么?为什么你的弹窗总在“溜号”?
不知道你有没有遇到过这种情况:在uniapp项目里,辛辛苦苦用u-popup组件做了一个漂亮的弹窗,点击按钮弹出来,遮罩层也盖住了背景,一切都显得那么完美。但是,当你用手指在弹窗上滑动时,尴尬的事情发生了——弹窗背后的页面内容,居然也跟着你的手指一起上下滚动!这种感觉,就像你明明关上了房间的门,但外面的风还是能呼呼地吹进来,体验非常糟糕。
这个问题,就是我们今天要彻底解决的 “滑动穿透”。简单来说,就是当弹窗(上层)出现时,触摸事件(特别是 touchmove 事件)没有被完全“拦截”在弹窗层内,而是“穿透”了弹窗的遮罩,传递到了底层的页面滚动容器上,从而触发了底层页面的滚动。
为什么u-popup组件容易有这个问题呢?这得从它的实现原理说起。u-popup组件为了保持灵活性和轻量,它的遮罩层通常只负责视觉上的遮挡,并没有默认强制阻止所有触摸事件。在移动端,页面的滚动行为本质上是由 touchmove 事件驱动的。当弹窗出现时,如果你在弹窗区域(包括遮罩)内滑动,这个 touchmove 事件如果没有被处理,就会沿着DOM树向上冒泡,最终可能被页面根元素的滚动监听器捕获,于是底层页面就“动”起来了。
我刚开始用的时候也踩过这个坑,在模拟器上测试好好的,一到真机上就“原形毕露”。用户反馈说弹窗时页面乱跳,我还一度怀疑是手机的问题。后来才明白,模拟器没有真实的触摸事件,很多滑动穿透的问题在电脑上是复现不出来的,必须用真机调试才能看到。所以,如果你在开发工具里没发现问题,千万别高兴得太早,一定要用手机的开发版或者自定义基座跑一下试试。
2. 方案一:事件拦截法——用@touchmove.stop.prevent“锁死”滑动
最直接、也是最被大家熟知的解决方案,就是使用Vue的事件修饰符来拦截触摸事件。这也是很多文章里第一时间会推荐的方法,我在最初的项目里也是这么干的。
2.1 核心代码与实操
思路很简单:在包裹 u-popup 的最外层容器上,添加一个 @touchmove.stop.prevent 事件监听。prevent 用于阻止事件的默认行为(在这里就是滚动),stop 用于阻止事件继续向上冒泡。这样一来,所有发生在弹窗区域内的触摸移动事件,都会在这个外层容器被“吃掉”,根本传不到底层页面去。
<template>
<view class="popup-wrapper" @touchmove.stop.prevent="handleTouchMove">
<u-popup :show="showPopup" mode="center" @close="closePopup">
<!-- 你的弹窗内容 -->
<view class="content">我是弹窗内容,现在背景页面不会滑动了</view>
</u-popup>
</view>
</template>
<script>
export default {
methods: {
handleTouchMove(e) {
// 这个方法可以留空,或者加一些调试日志
// console.log('触摸事件被拦截了', e)
},
closePopup() {
this.showPopup = false;
}
}
}
</script>
实测下来,这个方法在绝大多数场景下“很稳”,能立刻解决滑动穿透的问题。你不需要去动底层页面的任何样式或结构,只需要在弹窗组件外面套个壳并加上这个事件修饰符就行。
2.2 这个方法有个“天坑”
但是,先别急着把所有弹窗都改成这样。这个方法有一个非常致命的副作用:它会禁止弹窗内部所有元素的滚动。
这意味着,如果你的弹窗内容很长,超出了屏幕高度,用户是无法通过上下滑动来查看隐藏内容的。因为 @touchmove.stop.prevent 是把整个容器内的所有 touchmove 事件都无差别地阻止了。我就在一个商品详情弹窗上栽过跟头,弹窗里有一段很长的产品描述,加上这个修饰符后,内容多的用户
807



被折叠的 条评论
为什么被折叠?



