讲师中心 微信公众号
AI工具推荐 视频效率加速

uni-app上拉加载怎么实现 uni-app触底分页加载数据方案【代码】

阿浩君_7575

阿浩君_7575

发布时间:2026-04-21 12:07:20

|

232人浏览过

|

来源于php中文网

原创

onReachBottom未触发最常见原因是滚动容器非page根节点,如使用scroll-view导致局部滚动;应改用scroll-view的@scrolltolower事件并设固定height和scroll-y。

uni-app上拉加载怎么实现 uni-app触底分页加载数据方案【代码】

uni-app 的 onReachBottom 为什么没触发?

最常见原因是页面滚动容器不是 <page> 根节点,比如用了 <scroll-view> 或自定义高度的 <view>。uni-app 的 onReachBottom 默认监听的是整个页面(即 page)的滚动触底,一旦你用 <scroll-view> 包裹列表,它就变成局部滚动,onReachBottom 就失效了。

解决办法分两种:

  • 不用 <scroll-view>,让列表直接撑满页面,确保 page 可滚动(需在 pages.json 中关闭原生导航栏或留出足够内容高度)
  • 改用 <scroll-view> 的 @scrolltolower 事件,但必须显式设置 height 和 scroll-y,否则无法触发

注意:scroll-view 的 height 必须是固定数值(如 80vh 或具体 px),百分比在某些平台(尤其是微信小程序)可能不生效。

onReachBottom 触发后如何防重复请求?

用户快速上拉或网络慢时,容易连续触发多次,导致重复加载相同页码数据。不能只靠 loading 状态变量控制,因为异步请求未返回前状态可能已重置。

推荐做法:

  • 加一个 isLoadMore 标志位,在请求开始时设为 true,成功/失败后才设为 false
  • 每次请求前先判断 if (this.isLoadMore || this.hasMore === false) return
  • 后端返回数据时,明确提供 has_more: true/false 字段,而不是仅靠数组长度判断是否还有下一页

示例关键逻辑:

onReachBottom() {
  if (this.isLoadMore || !this.hasMore) return;
  this.isLoadMore = true;
  uni.request({
    url: '/api/list',
    data: { page: this.page + 1 },
    success: (res) => {
      this.page++;
      this.list.push(...res.data.list);
      this.hasMore = res.data.has_more;
    },
    complete: () => {
      this.isLoadMore = false;
    }
  });
}

微信小程序里 scroll-view 的 @scrolltolower 不触发?

这是高频兼容性问题:微信小程序要求 scroll-view 必须有明确的 height,且内部内容总高度必须 > height,否则不会出现滚动条,自然也不会触发 @scrolltolower。

uni-app
uni-app

uni-app 是基于 Vue 的跨端开发框架,适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载

实操要点:

  • 用 vh 单位比 % 更可靠,例如 height: calc(100vh - 100px)(减去顶部导航和 tabbar 高度)
  • 在 mounted 或 onReady 中用 uni.createSelectorQuery() 动态获取容器高度并赋值,避免硬编码
  • 确保子元素(如 <view v-for>)没有 position: absolute 或 flex: none 导致高度塌陷

错误写法:<scroll-view @scrolltolower="loadMore"></scroll-view>(缺 height、scroll-y)

正确写法:<scroll-view scroll-y="true" :style="{height: containerHeight + 'px'}" @scrolltolower="loadMore">

下拉刷新和上拉加载共存时的冲突点

启用 enablePullDownRefresh 后,部分安卓机或旧版微信开发者工具中,onReachBottom 会在下拉刷新完成后的首次滚动时误触发一次——本质是刷新后页面 scrollTop 被重置,触发了“触底”判定。

规避方式:

  • 在 onPullDownRefresh 里手动重置分页状态:this.page = 1; this.list = []; this.hasMore = true;
  • 在 onReachBottom 开头加判断:if (this.page === 1) return;(因为第一页已由下拉刷新加载完)
  • 不要在 onPullDownRefresh 里调用 uni.stopPullDownRefresh() 后立刻触发滚动,可加 setTimeout(() => {}, 100) 微调时机

另外,uni.startPullDownRefresh() 在某些平台(如 H5)不支持自动滚动到顶,需手动 this.$nextTick(() => uni.pageScrollTo({scrollTop: 0})) 配合。

真正麻烦的不是写法,而是不同平台对“滚动容器”和“触底判定”的实现差异——测试必须覆盖微信小程序、App、H5 三端,尤其注意真机调试时的滚动行为。

热门AI工具

更多
VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2443

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

5283

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

6330

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

5918

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

843

2024.05.22

ajax教程
ajax教程

php中文网为大家带来ajax教程合集,Ajax是一种用于创建快速动态网页的技术。通过在后台与服务器进行少量数据交换,Ajax可以使网页实现异步更新。这意味着可以在不重新加载整个网页的情况下,对网页的某部分进行更新。php中文网还为大家带来ajax的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2780

2023.06.14

ajax中文乱码解决方法
ajax中文乱码解决方法

ajax中文乱码解决方法有设置请求头部的字符编码、在服务器端设置响应头部的字符编码和使用encodeURIComponent对中文进行编码。本专题为大家提供ajax中文乱码相关的文章、下载、课程内容,供大家免费下载体验。

360

2023.08.31

ajax传递中文乱码怎么办
ajax传递中文乱码怎么办

ajax传递中文乱码的解决办法:1、设置统一的编码方式;2、服务器端编码;3、客户端解码;4、设置HTTP响应头;5、使用JSON格式。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2593

2023.11.15

VibeKnow知识视频制作与导出详解
VibeKnow知识视频制作与导出详解

本专题整理VibeKnow从注册、素材上传、AI生成到预览导出的完整操作,帮助新手快速制作第一条知识讲解视频。

0

2026.10.14

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn