Lenis 滚动库中实现动态无限滚动切换的技术方案
2025-05-22 10:19:21作者:农烁颖Land
概述
在基于 Lenis 平滑滚动库的开发过程中,实现动态切换无限滚动功能是一个常见的需求场景。本文将详细介绍如何通过技术手段实现这一功能,并分析其中的关键实现原理。
核心问题分析
Lenis 库本身提供了无限滚动(infinite scrolling)功能,但直接动态切换该选项会导致滚动行为异常停止。这是因为:
- 无限滚动模式需要额外的计算逻辑
- 选项变更后需要重新初始化相关计算
- 滚动状态需要正确恢复
解决方案实现
基本实现思路
通过监听页面滚动位置,在到达特定位置时动态开启无限滚动模式:
const lenis = useLenis(
({ options }) => {
options.infinite = hasReachedBottom ? true : false;
},
[hasReachedBottom]
);
关键修复步骤
- 使用 ScrollTrigger 检测位置:通过 GSAP 的 ScrollTrigger 检测是否到达页面底部
useGSAP(() => {
ScrollTrigger.create({
trigger: "footer",
start: "top center",
end: "bottom center",
onEnter: () => setHasReachedBottom(true),
});
}, [hasReachedBottom]);
- 延迟重置机制:添加 setTimeout 确保 Lenis 完成内部状态更新
useEffect(() => {
if (hasReachedBottom) {
setTimeout(() => {
lenis?.resize();
lenis?.start();
}, 10);
}
}, [hasReachedBottom]);
技术原理详解
- resize() 方法的作用:通知 Lenis 重新计算滚动容器尺寸和位置信息
- start() 方法的意义:在选项变更后重新启动滚动动画
- 10ms 延迟的必要性:确保 DOM 更新和状态变更完全生效
最佳实践建议
- 条件限制:建议只在特定路由下启用此功能
- 性能优化:避免频繁切换无限滚动模式
- 兼容性处理:考虑移动端和不同浏览器的表现差异
总结
通过合理组合 Lenis 的 API 调用和适当的延迟处理,开发者可以实现在页面滚动到底部时动态开启无限滚动的效果。这种技术方案特别适合单页应用中需要根据内容动态调整滚动行为的场景。关键在于理解 Lenis 内部状态管理机制,并通过 resize 和 start 方法的组合调用来确保平滑过渡。
登录后查看全文
热门项目推荐
相关项目推荐
Kimi-K2.5Kimi K2.5 是一款开源的原生多模态智能体模型,它在 Kimi-K2-Base 的基础上,通过对约 15 万亿混合视觉和文本 tokens 进行持续预训练构建而成。该模型将视觉与语言理解、高级智能体能力、即时模式与思考模式,以及对话式与智能体范式无缝融合。Python00
GLM-4.7-FlashGLM-4.7-Flash 是一款 30B-A3B MoE 模型。作为 30B 级别中的佼佼者,GLM-4.7-Flash 为追求性能与效率平衡的轻量化部署提供了全新选择。Jinja00
new-apiAI模型聚合管理中转分发系统,一个应用管理您的所有AI模型,支持将多种大模型转为统一格式调用,支持OpenAI、Claude、Gemini等格式,可供个人或者企业内部管理与分发渠道使用。🍥 A Unified AI Model Management & Distribution System. Aggregate all your LLMs into one app and access them via an OpenAI-compatible API, with native support for Claude (Messages) and Gemini formats.JavaScript01
idea-claude-code-gui一个功能强大的 IntelliJ IDEA 插件,为开发者提供 Claude Code 和 OpenAI Codex 双 AI 工具的可视化操作界面,让 AI 辅助编程变得更加高效和直观。Java01
KuiklyUI基于KMP技术的高性能、全平台开发框架,具备统一代码库、极致易用性和动态灵活性。 Provide a high-performance, full-platform development framework with unified codebase, ultimate ease of use, and dynamic flexibility. 注意:本仓库为Github仓库镜像,PR或Issue请移步至Github发起,感谢支持!Kotlin07
compass-metrics-modelMetrics model project for the OSS CompassPython00
最新内容推荐
麒麟云打印windows服务端与linux客户端:跨平台打印的完美解决方案 QT开发软件中文版下载介绍:跨平台Qt IDE,助力高效开发 TinyTask录屏重复执行工具:智能录屏,高效重复,释放双手【免费下载】【docker安装】 基于docker-compose快速部署spiderflow:一键部署,畅享高效爬虫体验 Fluent组分运输模型源项设置文档 IEC104 模拟器 (客户端、服务端 ) 机器学习/深度学习:income数据集 nvme-cli源码下载介绍:Linux系统下强大的NVMe设备管理工具 WPFVisifire.Charts资源文件介绍:强大的图表绘制工具 javax jar集合包资源下载介绍
项目优选
收起
deepin linux kernel
C
27
11
OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
519
3.69 K
Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台,包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分,采用java语言实现,可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用
Java
12
1
🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer(第 2 版)》、《程序员面试金典(第 6 版)》题解
Java
67
20
暂无简介
Dart
761
182
喝着茶写代码!最易用的自托管一站式代码托管平台,包含Git托管,代码审查,团队协作,软件包和CI/CD。
Go
23
0
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
1.32 K
740
无需学习 Kubernetes 的容器平台,在 Kubernetes 上构建、部署、组装和管理应用,无需 K8s 专业知识,全流程图形化管理
Go
16
1
React Native鸿蒙化仓库
JavaScript
301
347
基于golang开发的网关。具有各种插件,可以自行扩展,即插即用。此外,它可以快速帮助企业管理API服务,提高API服务的稳定性和安全性。
Go
22
1