uni-app支付宝端彻底禁掉下拉刷新效果

前情

uni-app是我比较喜欢的跨平台框架,它能开发小程序/H5/APP(安卓/iOS),重要的是对前端开发友好,自带的IDE让开发体验也挺棒的,公司项目就是主推uni-app,解决了公司一套代码发布快抖微支四端的需求

坑位

按我以往开发快抖微小程序的开发经验,我只要在page.json关闭下拉刷新,这样就可以关掉页面的下拉刷新同时页面不会有向下拉拽效果

jsx 复制代码
"pages": [
    ...
    {
      "path" : "/pages/OrderList/OrderList",
      "style" :
      {
        "navigationBarTitleText" : "订单列表",
            "enablePullDownRefresh": false,
      }
    }
    ...
]

但是实际上支付宝端还是有下拉效果,只是不会触发onPullDownRefresh生命钩子,其实此时已经关掉了下拉刷新,只是这效果容易让人误解,详见下图:

解决方案

方案1:通过pages.json配置关掉支付宝小程序的允许向下拉拽

选通过"enablePullDownRefresh": false禁掉下拉刷新效果,我们再针对支付宝做特殊配置,通过"allowsBounceVertical": "NO"禁用支付宝的向下拉拽效果,此处使用了uni-app的条件编译来实现对支付宝的特有配置,关键配置如下:

jsx 复制代码
"pages": [
    ...
    {
      "path" : "/pages/OrderList/OrderList",
      "style" :
      {
        "navigationBarTitleText" : "订单列表",
            "enablePullDownRefresh": false,
            // #ifdef MP-ALIPAY
            "allowsBounceVertical": "NO"
            // #endif
      }
    }
    ...
]

注:allowsBounceVertical 配置不是true和false,它对应的是YES(开启下拉)和NO(关闭下拉)

方案2:通过API关掉支付宝小程序的允许向下拉拽

下拉刷新效果通过pages.json下的"enablePullDownRefresh": false禁用,至于向下拉拽效果支付宝不但提供了通过pages.json配置关掉它,同时也提供了API来控制它,此处同样使用了uni-app的条件编译来实现对支付宝的单独调用一些特有的API,关键代码如下:

jsx 复制代码
"pages": [
    ...
    {
      "path" : "/pages/OrderList/OrderList",
      "style" :
      {
        "navigationBarTitleText" : "订单列表",
            "enablePullDownRefresh": false
      }
    }
    ...
]
jsx 复制代码
// #ifdef MP-ALIPAY
my.setCanPullDown({
  canPullDown: true,
})
// #endif

思考

此文主要是讲解怎么禁用下拉刷新,举一反三,如果你页面要实现下拉刷新效果,只需要增加如下配置即可,因为支付宝小程序的allowsBounceVertical 默认为YES

jsx 复制代码
"pages": [
    ...
    {
      "path" : "/pages/OrderList/OrderList",
      "style" :
      {
        "navigationBarTitleText" : "订单列表",
            "enablePullDownRefresh": false
      }
    }
    ...
]

uni-app是多端框架,但是它并没有抹平所有端的效果,对于遇到一端可以一端不行的问题,我们可以去对应小程序官网文挡查阅特有的配置,再使用条件编译来手动抹平各端的差异,uni-app的条件编辑就是解决各端差异的最有效手段,我感觉这是uni-app向跨端开发者提供的杀手锏

相关推荐
随风一样自由5 小时前
【前端独角兽】刚进入前端领域的前端开发用jQuery还是Vue3?
前端·javascript·vue3·jquery
IMPYLH5 小时前
HTML 的 <data> 元素
前端·html
YHHLAI6 小时前
[特殊字符] 面试中的 Promise —— 从入门到精通
前端·javascript·面试
kyriewen7 小时前
我扒了 GPT-5.6 的全部编程跑分——有一项 OpenAI 没敢放出来
前端·gpt·ai编程
小羊Yveesss8 小时前
2026年微信小程序搭建一般需要多长时间?不同方案周期和延期点
微信小程序·小程序
前端H8 小时前
微前端 v3 架构升级:从加载隔离到状态协同
前端·架构·状态模式
陆枫Larry9 小时前
小程序包体积优化:用 SVG 图片替换 iconfont,并保留 CSS 控色能力
前端
禾高网络10 小时前
互联网医院|AI 互联网医院成品开发系统
java·大数据·人工智能·小程序
环境栈笔记10 小时前
多账号浏览器选型检查清单:Profile、权限、Session 和任务日志怎么评估
前端·人工智能·后端·自动化
前端炒粉11 小时前
手写promise
java·前端·javascript