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向跨端开发者提供的杀手锏

相关推荐
东风破_38 分钟前
TypeScript 高级类型进阶:keyof、Exclude、Record 与类型组合思想
前端·后端·typescript
DS随心转插件1 小时前
Grok生成的html怎么导出——AI导出鸭:大模型结构化输出的“最后一公里”工程化解构
前端·人工智能·ai·html·豆包·deepseek·ai导出鸭
এ慕ོ冬℘゜1 小时前
使用 jQuery 动态渲染表格与状态切换
前端·javascript·jquery
人间凡尔赛2 小时前
2026 前端必修:4 个让 CSS 脱胎换骨的现代新特性(附实战代码)
前端·css
用户2181697049302 小时前
Flutter (二十) 轮播图
前端
前端snow2 小时前
ai agent - RAG 汇总
前端
计算机魔术师3 小时前
AI为拿高分不惜入侵网站:22个模型作弊审计,真相让人背脊发凉
前端
晓说前端3 小时前
TypeScript 核心语法应用 —— Vue 3 中的使用(下)
前端·javascript·typescript·类型系统
qq_316837753 小时前
uniapp + Vite + ffmpeg-wasm 0.12.x 集成示例
ffmpeg·uni-app·wasm
zhangminghuan3 小时前
微信小程序开发核心知识点全景解析(前端必备硬核基础)
前端·微信小程序·小程序