评论

如何彻底解决小程序滚动穿透问题

解决微信小程序滚动穿透的终极方案。

背景

俗话说,产品有三宝:弹窗、浮层加引导,足以见弹窗在产品同学心目中的地位。对任意一个刚入门的前端同学来说,实现一个模态框基本都可以达到信手拈来的地步,但是,当模态框里边的内容滚动起来以后,就会出现各种各样的让人摸不着头脑的问题,其中,最出名的想必就是滚动穿透。
那么,什么是滚动穿透呢?滚动穿透即:移动端弹出fixed弹窗的话,在弹窗上滑动会导致下层的页面跟着滚动,这个叫 “滚动穿透”。了解了什么是滚动穿 透以及它出现的场景,那么,接下来就直接进入正题。

那我们如何解决该问题呢?

  • 页面最外层view设置position: fixed;页面不可滚动,但是这个时候会导致页面回到顶部(不推荐)。
  • 滚动时监听滚动距离,弹窗时记录滚动位置,关闭弹窗后使用wx.pageScrollTo回滚到记录的位置(不推荐,比较消耗性能)。
  • 使用page-meta组件,通过该组件我们可以操作Page的style样式,类似于h5里body设置overlow: hidden; 控制页面不可滚动。文档地址:https://developers.weixin.qq.com/miniprogram/dev/component/page-meta.html (推荐,官方组件,比较好用)
  • 使用wx.setPageStyle设置overflow: hidden; 也可以实现给Page组件设置样式。(次要推荐,调用方式简单,但由于官方未对外透出该API,存在下架风险)

page-meta组件:

通过该组件我们可以直接操作Page组件 ,我们给它的wxss样式overflow动态设置hiddenorvisibleorauto 就可以控制整个页面是否可以滚动。

示例代码:
<page-meta page-style="overflow: {{visible ? 'hidden' : 'visible'}}" />
<button class="button" bindtap="handleClick">点我弹出弹窗</button>
<!-- 模拟页面滚动 -->
<view wx:for="{{300}}" wx:key="index">{{item}}</view>
<!-- 模拟弹窗 -->
<view class="dialog-wrap {{visible ? 'active' : ''}}">
  <view class="dialog-back {{visible ? 'active' : ''}}"></view>
  <view class="share-box-container {{visible ? 'active' : ''}}">
    <view class="share-content">
      <!-- 模拟弹窗内容滚动 -->
      <view class="share-box" wx:for="{{300}}" wx:key="index">{{item}}</view>
    </view>
  </view>
</view>
控制弹窗显隐藏:
const app = getApp()

Page({
  data: {
    visible: false
  },
  onLoad() {
   
  },
  handleClick() {
    this.setData({
      visible: !this.data.visible
    })
  }
})
wxss弹窗样式太多,这里就不贴,放代码片段里了。

兼容底部是scroll-view,以及弹窗内是scroll-view都不会穿透影响底部的内容。


wx.setPageStyle方法:

调用这个api,动态设置它为hidden/visible,用于控制页面是否可滚动

wx.setPageStyle({
   style: {
     overflow: 'hidden'
   }
})

老规矩,结尾放代码片段:

https://developers.weixin.qq.com/s/U6ItgQmP7upQ

最后一次编辑于  2023-08-10  
点赞 47
收藏
评论

17 个评论

  • 小刘
    小刘
    2021-12-13

    跟 web 里面的 Helmet 组件有点儿类似,可以用来修改 page-meta 信息。

    2021-12-13
    赞同 2
    回复
  • 2021-10-19

    page-meta 组件在 iPhone8 上无效,大佬们有遇到这种兼容问题吗?

    2021-10-19
    赞同 1
    回复 21
    • 睡前原谅一切
      睡前原谅一切
      2021-10-20
      查看下你的微信客户端版本是多少,再看对应的基础库是多少。这个组件有最低基础库限制的
      2021-10-20
      1
      回复
    • 2021-10-20回复睡前原谅一切
      好的,我看下,感谢回复。
      2021-10-20
      回复
    • 2021-10-20回复睡前原谅一切
      手机微信升级到最新版本8.0.15,调试基础库为2.20.0。还是没生效
      2021-10-20
      回复
    • 睡前原谅一切
      睡前原谅一切
      2021-10-20回复
      提供代码片段看下。我看下你是不是写错了。。。
      2021-10-20
      回复
    • 2021-10-20回复睡前原谅一切
      2021-10-20
      回复
    查看更多(16)
  • yimi🌸
    yimi🌸
    2021-10-15

    弹窗弹出时,直接把底部的scroll-view的scroll-y设置为false,就可以阻止底层滚动了呀,不需要用这个page-meta吧

    2021-10-15
    赞同 1
    回复 2
    • 睡前原谅一切
      睡前原谅一切
      2021-10-15
      底部内容超出一屏。弹窗内有滚动会导致滚动穿透。而这个组件的作用跟 h5的控制body设置为overflow hidden控制底部不可滚动 是一样的原理。
      2021-10-15
      回复
    • yimi🌸
      yimi🌸
      2021-10-18回复睡前原谅一切
      哦,我知道了,我以为最外层结构是scroll-view,没看清。这个的确是最佳方法👍
      2021-10-18
      回复
  • 困难
    困难
    2021-10-08

    感谢大佬。之前用catchtouchmove解决,后来弹窗变复杂就突然不好使了。。这个方法确实简单快捷

    2021-10-08
    赞同 1
    回复
  • 悦己
    悦己
    2021-07-15

    麻烦问下pageMeta在taro中怎么使用啊?

    2021-07-15
    赞同 1
    回复 3
    • 夜 惊 魂
      夜 惊 魂
      2021-08-03
      请问你解决了嘛😂
      2021-08-03
      回复
    • Gavin
      Gavin
      2021-08-24
      Taro有个方法你可以看看
      2021-08-24
      1
      回复
    • 东昇鸿旭
      东昇鸿旭
      发表于移动端
      2022-03-10回复Gavin
      、:-:
      2022-03-10
      回复
  • 陈关羽
    陈关羽
    2021-05-31

    老哥 这个方法很稳

    2021-05-31
    赞同 1
    回复
  • 来一间
    来一间
    2021-05-14

    https://developers.weixin.qq.com/community/develop/article/doc/000e40918dc420f5f61c2001a56013,这一篇写得特别详细,楼主也可以看看!

    2021-05-14
    赞同 1
    回复 3
    • HGP
      HGP
      2021-05-19
      这个链接是广告,然后这个层主是s13
      2021-05-19
      24
      回复
    • 2022-09-19回复HGP
      必须登录给你个赞
      2022-09-19
      回复
    • 骑着毛驴逗你玩儿
      骑着毛驴逗你玩儿
      03-27
      拉出去弹蛋蛋 10 分钟...
      03-27
      回复
  • 🇪 🇱 🇸 🇪
    🇪 🇱 🇸 🇪
    2023-06-08

    收藏起来

    2023-06-08
    赞同
    回复
  • Dodeca.
    Dodeca.
    2023-05-30

    [渲染层错误] [Component] <page-meta>: 只能是页面内的第一个节点,且不能被 wx:if 或 wx:for 动态变更

    2023-05-30
    赞同
    回复 3
  • 不熬夜&不改名
    不熬夜&不改名
    2022-07-21

    很有效,不过感觉切换的时候有些卡顿

    2022-07-21
    赞同
    回复 8
    • 睡前原谅一切
      睡前原谅一切
      2022-07-21
      原理是类似于h5的body给他设置为overflow: hidden了,页面就不能滑动了。至于卡顿可能是你手机性能问题?我用了这么久一直很流畅。
      2022-07-21
      回复
    • 不熬夜&不改名
      不熬夜&不改名
      2022-07-21回复睡前原谅一切
      之前我是按其他人的说法,给整个页面套个壳,然后设置height:100%;overflow: hidden,只可惜在ios上没有效果
      2022-07-21
      回复
    • 睡前原谅一切
      睡前原谅一切
      2022-07-22回复不熬夜&不改名
      可以试试底部的api方法
      2022-07-22
      回复
    • 好命先生
      好命先生
      2022-09-22回复睡前原谅一切
      wx.setPageStyle 这个方法好想会提示找不到,报错了。
      2022-09-22
      1
      回复
    • 睡前原谅一切
      睡前原谅一切
      2022-09-26回复好命先生
      测试生效的。
      2022-09-26
      回复
    查看更多(3)

正在加载...

登录 后发表内容