在Tarojs的VirtualList组件中支持下拉刷新功能

前情提要

最近在使用Tarojs做开发,主要用于微信小程序和h5,遇到了很多兼容性问题。比如本文要说的虚拟列表组件。项目中使用的tarojs版本是3.6.14,官网文档中说虚拟列表有onScrollToUpper事件,实际使用却没有,查看源码后也没有看到相关代码,不知道是哪里有问题,有知道的小伙伴可以说下~

先看效果

实现方案

其实实现下拉刷新功能本身是比较容易的,基本上就是在touchstart,touchmove,touchend上做处理,关键还是在兼容性和其他各种异常的处理上。

判定下拉刷新操作

通常情况下,只需要判断滚动条位置为0的时候,就可以认为已经在顶部了,对于touch就可以进入下拉刷新的代码了。但是virtualList中却不能根据这个来判断,在virtualList中通过监听scroll事件获取到的滚动条偏移量scrollOffset,他只是个参考值,甚至可能是负的。

解决方案,通过dom查找的方式获取到列表的第一个元素,因为virtualList默认是用绝对定位来实现的,所以只需要找到style.top的值是0的就是第一个元素。通过在初始化的时候记录下该元素的位置信息(使用boundingClientRect函数获取),将其top值记录下来。当页面上存在第一个元素,并且他的当前位置和初始位置相同,就可以认为他是回到了初始位置,也就是回到了顶部。

特殊的,在微信小程序端通过Taro.createSelectorQuery()的方式查找到节点,此操作是异步的。如果是在快速滚动操作时,可能最终查找的节点位置信息是滚动操作后的(不准确的),所以又必须保证异步计算的结果是当时的快照,所以用了订阅-发布的形式。如果判断touchstart时的位置是顶部的,就追加一个下拉的动画效果(动画就是在touchmove中将移动的偏移量赋值到刷新面板的高度上)。

相关推荐
Larcher12 小时前
# 告别“古法编程”:吴恩达 AI 课程学习笔记与生日贺卡项目实战
前端·github·ai编程
用户8524950718412 小时前
# 大二前端新人的AI初体验:跟着吴恩达学“Vibe Coding”,我如何用提示词“指挥”AI写代码?
前端
bupt_0112 小时前
Hermes深入理解及源码解析(二):Hermes的记忆机制
java·服务器·前端
飘尘12 小时前
WebAssembly 是什么?它为什么重要?
前端·javascript
情绪总是阴雨天~12 小时前
大模型 Function Call(函数调用)详解:原理、实践与数据库智能查询 Agent
前端·数据库·人工智能
GalenZhang88813 小时前
OpenClaw (2026.4.x 至 2026.5.12) 升级问题及解决
前端·chrome·openclaw
Ww.xh13 小时前
鸿蒙Web组件中Hash路由传登录态方案
前端·哈希算法·harmonyos
LCG元14 小时前
STM32实战:基于STM32F103的智慧教室环境监控系统(CO₂+光照+人数统计)
前端·stm32·嵌入式硬件
yqcoder14 小时前
Vue 的心脏:深度解析 Vue 2 vs Vue 3 响应式机制
前端·javascript·vue.js
东方小月14 小时前
Claude Code Skill 完全指南:一个 markdown 文件,就是一个专家分身
前端·后端