uniapp中u-popup弹窗滑动穿透问题的终极解决方案

uniapp使用u-popup组件弹窗出现页面还可滑动 解决u-popup出现遮罩层页面滑动问题 阅读详情

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 事件都无差别地阻止了。我就在一个商品详情弹窗上栽过跟头,弹窗里有一段很长的产品描述,加上这个修饰符后,内容多的用户

uniapp uview使用u-popup组件当开启遮罩层禁止下层页面滚动。uniapp弹框禁止页面上下滚动。 uniapp uview使用u-popup组件当开启遮罩层禁止下层页面跟着滚动。 uniapp 弹框禁止页面上下滚动 阅读详情

相关推荐

u-popup弹窗避坑指南:为什么加了@touchmove.stop.prevent还是能滑动?

本文深入解析uniapp中u-popup弹窗滑动穿透问题的根源,提供从基础事件阻止到全局事件拦截的多层次解决方案。针对不同场景和版本兼容性,详细介绍了如何有效使用@touchmove.stop.prevent等技巧,帮助开发者彻底解决弹窗滑动穿透难题。

moss5的博客 807

解决移动端滚动穿透问题

移动端当弹出遮罩层滚动时,底部禁止滚动,完美解决穿透问题

STM32F103开发实战:如何用CubeMX+CLion调整Flash起始地址(附完整CMake配置)

本文详细介绍了在STM32F103开发中如何使用CubeMX和CLion工具链调整Flash起始地址,包括链接脚本修改、系统文件配置和CMake工程适配。通过实战步骤和完整配置示例,帮助开发者实现固件双备份、OTA升级等高级功能,提升嵌入式开发效率。

5b6n7m8的博客 212

set_data_check专题[使用,report_timing,setup/hold检查]

set_data_check用于约束『数据-对-数据』的『建立保持』时间检查,通常被称为非时序约束 ( non-sequential constraints ), 理论上set_data_check 可以设在任意的两个data pin 上,其中一个pin 称为 constrained pin 类似于寄存器的data pin, 另一个pin 称为related pin 类似于寄存器的clock pin.

cy413026的博客 1万+

当AI换脸遇上内容审核:Facefusion NSFW检测的技术伦理与用户自主权之争

本文探讨了Facefusion开源AI换脸工具中NSFW检测机制的技术伦理困境与用户自主权之争。分析了其多层次防御机制的技术实现与社区规避方法,揭示了开源软件在安全与自由之间的平衡难题,并提出了分层权限设计等社区实践方案。

weixin_29165725的博客 726

什么是深度展开网络?如何将迭代算法的每一次迭代展开成深度网络对应的一层?深度展开网络进行端对端训练,其中端对端是什么意思?

在深度学习和机器学习的背景下,“端到端”(End-to-end)训练指的是将输入数据直接映射到最终输出的过程,而不需要任何中间的手动数据预处理或特征工程。- **自然语言处理**:端到端自然语言处理系统可以将自然语言输入直接转化为计算机可理解的语言输出,而不需要对语言进行分解和转化。- **推荐系统**:通过使用深度神经网络,端到端推荐系统可以直接根据用户历史行为预测其未来的兴趣爱好,并推荐相应的产品或服务。4. **直接映射**:从输入到输出的直接映射,中间没有任何拆分或分解的过程。

m0_67897882的博客 5453

【单智能体】AI 数据分析智能体案例讲解(附完整源码)

本案例将引导您构建一个基于 AI 的数据分析智能体,让用户能够通过自然语言查询来分析 CSV 和 Excel 文件中的数据,无需掌握 SQL 知识。该智能体使用 Agno Agent 框架集成 OpenAI GPT-4o 模型,并利用 DuckDB 提供高效的数据处理能力。

rengang66的博客 241

FPGA+CUYSB3014实现USB3.0功能

CYUSB3014是赛普拉斯在近几年推出的新一代USB3.0的外设控制器,可以解决USB2.0带宽限制,或者单独开发USB协议和驱动的难题。赛普拉斯将CYUSB3014简称为EZ-USB FX3,具有高度的灵活特性,开发人员只需要下载FX3的固件库,就能使用USB3.0的功能。目前在一些电子产品中,使用主控器加PHY芯片最流行的方式是用FPGA+FX3这种搭配来实现USB3.0接口。......

D_Katter的博客 7073

软件设计师---UML

软件设计师---UML

我从不打没有准备的仗! 1万+

数据结构课程设计C/C++版--美团餐馆预定信息的管理与分析 13 14

本关任务:编写一个能修改商家信息的程序。商家成功登录后,保存并显示当前商家信息。输入修改后的商家类型、地址和电话,调用基于链地址法的散列查找算法,找到当前商家并修改其信息。重新读取修改后的文件,根据商家名称查找修改后的商家信息,该商家信息和输入的修改信息一致,说明写文件成功,输出“修改成功!测试输入:百叶居·老北京涮羊肉(田村店),126832418,北京菜,海淀区田村路京粮广场2楼,126832417;无奈,直接打印结果了。根据提示,在右侧编辑器补充代码,实现修改商家信息的功能。额外打印输出代码如下。

m0_62222486的博客 493

Camera2Demo

在Camera2 的基础上进行封装,使得Camera2一堆初始化逻辑与Activity分离,降低耦合度,完成预览拍照并保存的操作

全球国家地区城市数据

MySQL全球国家地区城市数据报。。。。。。。。。。。。

大中型超市收银系统(可直接运行)

光步前台收银系统系统功能:商品销售、商品退货、挂单、收银员权限、会员销售、单品取消、整单取消、商品查询、脱机销售、脱机数据上传,基本资料下载,开钱箱、小票打印、收款结算,支持多币种付款方式(现金、储值卡、礼券、微信等),支持多种促销。运行环境:.net 4.0登陆信息用户名:1001 密码:123456内置商品信息,商品编码可输入00001000 - 00010000,测试效果相关功能键F5 结算 F9挂单 F11商品查询 F8退货 Insert单品取消 Del整单取消 F12开钱箱F2 会员 Ctrl+Z退出系统 Home 锁屏 相关源码待公开

jdk-8u144-linux-x64.tar.gz.

该资源为搭建Linux系统Java环境用,资源的后缀为tar.gz格式的压缩包

上一篇: 火山方舟AI App Lab实战指南:从零构建企业级AI大模型应用的完整路径
下一篇: 深入解析MTK DRM初始化流程:从KMS模块到组件框架
onion
博客等级 码龄27年 457粉丝 1283原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符  | 博主筛选后可见
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值
⌂ 换网址