首页/新闻资讯/正文详情

HarmonyOs应用《重要日》开发第20篇 - Swiper + LazyForEach 实现日历无限滚动

发布时间:2026/11/21 12:26:35 来源:云帆数科 栏目:资讯中心
HarmonyOs应用《重要日》开发第20篇 - Swiper + LazyForEach 实现日历无限滚动
本文深入解析 ImportantDays 项目中日历无限滚动的实现方案探讨Swiper组件与LazyForEach的配合使用、IDataSource接口的实现、数据动态追加/前插策略以及在鸿蒙应用中实现高性能无限滚动的最佳实践。一、无限滚动的需求日历应用需要支持用户左右滑动浏览任意月份这就要求日历能够无限延伸。但手机内存有限不可能预生成所有月份的数据。解决方案是预加载少量月份如 3 个月滑动到边界时动态追加新数据使用LazyForEach只渲染可见项二、技术方案概述Swiper (水平滑动容器) ↓ LazyForEach (懒加载渲染) ↓ CalendarDataSource (IDataSource 实现) ↓ DateModelList[] (月份数据数组)各组件职责组件职责Swiper提供水平滑动交互管理页面切换LazyForEach按需渲染可见页面回收不可见页面CalendarDataSource管理数据数组通知数据变化CalendarVM生成月份数据处理边界追加逻辑三、IDataSource 接口LazyForEach要求数据源实现IDataSource接口exportinterfaceDataChangeListener{onDataReloaded():void;onDataAdded(index:number):void;onDataChanged(index:number):void;onDataDeleted(index:number):void;onDataMoved(from:number,to:number):void;}exportinterfaceIDataSource{totalCount():number;getData(index:number):Object;registerDataChangeListener(listener:DataChangeListener):void;unregisterDataChangeListener(listener:DataChangeListener):void;}接口方法说明方法作用totalCount()返回数据总量getData(index)获取指定位置的数据registerDataChangeListener()注册数据变化监听器unregisterDataChangeListener()注销监听器四、MonthWeekDataSource 实现exportclassMonthWeekDataSourceimplementsIDataSource{privatelisteners:DataChangeListener[][];privatedata:DateModelList[][];totalCount():number{returnthis.data.length;}getData(index:number):DateModelList{returnthis.data[index];}registerDataChangeListener(listener:DataChangeListener):void{if(this.listeners.indexOf(listener)0){this.listeners.push(listener);}}unregisterDataChangeListener(listener:DataChangeListener):void{constposthis.listeners.indexOf(listener);if(pos0){this.listeners.splice(pos,1);}}// 数据操作方法addData(data:DateModelList):void{...}addDataFromHead(data:DateModelList):void{...}clearData():void{...}setData(data:DateModelList[]):void{...}privatenotifyDataReload():void{this.listeners.forEach(listener{listener.onDataReloaded();});}}监听器模式MonthWeekDataSource维护一个监听器列表当数据变化时通过notifyDataReload()通知所有注册的LazyForEach重新加载数据。数据操作方法// 尾部追加向未来滚动addData(data:DateModelList):void{this.data.push(data);this.notifyDataReload();}// 头部插入向过去滚动addDataFromHead(data:DateModelList):void{this.data.unshift(data);this.notifyDataReload();}// 清空clearData():void{this.data[];this.notifyDataReload();}五、Swiper LazyForEach 的使用MonthWeekCalendar 中的实现Swiper(this.swiperController){LazyForEach(this.vm.monthWeekDataSource,(data:DateModelList){Column(){if(this.vm.viewTypeViewTypeEnum.MONTH){this.monthGrid(data)}else{this.weekRow(data)}}},(data:DateModelList,index:number)month_${index})}.cachedCount(CALENDAR_SWIPER_COUNT)// 缓存3页.index(this.vm.currentSwiperIndex)// 初始索引.loop(false)// 不循环.indicator(false)// 不显示指示器.onChange((index:number){this.handleSwiperChange(index);})关键配置配置值说明cachedCount3缓存前后各3页保证滑动流畅index1初始显示中间页当月loopfalse不循环使用动态追加实现无限indicatorfalse隐藏底部指示器LazyForEach 的键值生成(data:DateModelList,index:number)month_${index}键值使用索引生成。注意当头部插入数据时索引会变化此时通过onDataReloaded()通知全量刷新。六、无限滚动的核心逻辑初始化privateinitCalendarData():void{this.monthWeekDataSource.clearData();for(leti-1;i1;i){constdatedayjs().add(i,month);this.monthWeekDataSource.addData(this.getDateList(date));}}初始加载 3 个月上月、当月、下月。边界检测与追加handleHorizontalSwiper(index:number):void{if(indexthis.monthWeekDataSource.totalCount()-1){// 滑到最后一个追加下一个月constlastDatathis.monthWeekDataSource.getData(this.monthWeekDataSource.totalCount()-1);constlastDatelastData[15].dayjsObj;constnextMonthlastDate.add(1,month);this.monthWeekDataSource.addData(this.getDateList(nextMonth));}elseif(index0){// 滑到第一个前插上一个月constfirstDatathis.monthWeekDataSource.getData(0);constfirstDatefirstData[15].dayjsObj;constprevMonthfirstDate.subtract(1,month);this.monthWeekDataSource.addDataFromHead(this.getDateList(prevMonth));}}滚动场景示例场景1向右滚动未来初始: [12月] [1月*] [2月] (* 当前) 滑到2月: [12月] [1月] [2月*] 检测到末尾 → 追加3月: [12月] [1月] [2月*] [3月] 继续滑动: [12月] [1月] [2月] [3月*] 检测到末尾 → 追加4月: [12月] [1月] [2月] [3月*] [4月]场景2向左滚动过去初始: [12月] [1月*] [2月] 滑到12月: [12月*] [1月] [2月] 检测到开头 → 前插11月: [11月] [12月*] [1月] [2月]前插的索引处理前插数据时unshift会在数组头部插入元素导致所有索引后移。此时需要保持 Swiper 的当前显示页不变// MonthWeekCalendar 中的处理privatehandleSwiperChange(index:number):void{this.vm.currentSwiperIndexindex;this.vm.handleHorizontalSwiper(index);constcurrentDatathis.vm.monthWeekDataSource.getData(index);if(currentDatacurrentData.length15){constmiddleDatecurrentData[15].dayjsObj;if(!this.vm.selectDate.isSame(middleDate,month)){this.vm.selectDatemiddleDate;}}}前插后notifyDataReload()触发全量刷新Swiper 会根据currentSwiperIndex重新定位。七、YearDataSource 的实现年视图使用相同的数据源模式exportclassYearDataSourceimplementsIDataSource{privatelisteners:DataChangeListener[][];privatedata:number[][];// 存储年份数字// 接口实现与 MonthWeekDataSource 类似// ...addData(year:number):void{this.data.push(year);this.notifyDataReload();}addDataFromHead(year:number):void{this.data.unshift(year);this.notifyDataReload();}}年视图的无限滚动privatehandleYearSwiperChange(index:number):void{if(indexthis.yearDataSource.totalCount()-1){constlastYearthis.yearDataSource.getData(this.yearDataSource.totalCount()-1);this.yearDataSource.addData(lastYear1);}elseif(index0){constfirstYearthis.yearDataSource.getData(0);this.yearDataSource.addDataFromHead(firstYear-1);}constcurrentYearthis.yearDataSource.getData(index);this.currentYearcurrentYear;this.vm.selectDatethis.vm.selectDate.year(currentYear);}八、LazyForEach 的性能优势与 ForEach 的对比特性ForEachLazyForEach渲染时机一次性渲染全部按需渲染可见项内存占用与数据量成正比恒定仅可见项滚动性能数据多时卡顿始终流畅适用场景少量数据大量/无限数据cachedCount 的作用.cachedCount(CALENDAR_SWIPER_COUNT)// 3cachedCount控制预渲染的页面数。设为 3 表示当前页前 3 页预渲染后 3 页预渲染预渲染确保滑动时新页面已准备好不会出现白屏。九、数据源与组件的生命周期组件 aboutToAppear ↓ LazyForEach 注册 DataChangeListener ↓ 数据源 notifyDataReload → listener.onDataReloaded() ↓ LazyForEach 调用 totalCount() 和 getData() ↓ 渲染可见页面 ↓ 用户滑动 → Swiper.onChange ↓ handleSwiperChange → 追加数据 ↓ notifyDataReload → 重新渲染 ↓ 组件 aboutToDisappear ↓ unregisterDataChangeListener十、常见问题与解决方案问题1前插数据后页面跳动前插数据导致索引变化Swiper 可能跳到错误的位置。解决方案前插后通过notifyDataReload()全量刷新并确保currentSwiperIndex正确设置。问题2内存持续增长无限追加数据会导致数组越来越大。解决方案可以设置最大缓存数超过后移除最远的数据本项目未实现但可作为优化方向。问题3键值冲突如果使用日期字符串作为键值前插后同一日期的键值可能重复。解决方案使用索引作为键值month_${index}前插后通过onDataReloaded全量刷新。十一、总结SwiperLazyForEachIDataSource是鸿蒙应用中实现无限滚动的标准方案Swiper提供滑动交互容器LazyForEach按需渲染保证性能IDataSource封装数据管理支持动态增删边界检测 动态追加实现无限效果这种模式不仅适用于日历也可推广到图片轮播、新闻列表等任何需要无限滚动的场景。

相关推荐

HarmonyOs应用《重要日》开发第19篇 - EntryAbility 应用入口与生命周期管理
HarmonyOs应用《重要日》开发第19篇 - EntryAbility 应用入口与生命周期管理

本文深入解析 ImportantDays 项目中的应用入口 EntryAbility,包括 UIAbility 的生命周期回调、初始化流程(Preferences → Manager → 通知检查)、窗口管理、前台提醒检查机制,以及应用配置的关联关系。一、UIAbility 概述 UIAbil… · 2026/9/23 15:54:12

SolidWorks_钣金设计18_钣金工程图规范
SolidWorks_钣金设计18_钣金工程图规范

钣金工程图规范:标注展开图、折弯线、折弯角度及下料尺寸的完整指南 摘要 钣金工程图是连接设计意图与制造工艺的核心技术文档。本文系统性地阐述了钣金工程图的规范标注方法,重点涵盖展开图的绘制与标注、折弯线的精确表达、折弯角度的标准标注以及下料… · 2026/9/23 15:54:05

SolidWorks_钣金设计17_钣金设计与装配
SolidWorks_钣金设计17_钣金设计与装配

钣金设计与装配:在装配体中参考相邻零件设计配套的钣金支架 摘要 在机械产品开发过程中,钣金支架的设计往往需要与相邻零件紧密配合。传统的“孤立设计”方式容易导致装配干涉、孔位偏移等问题。本文将深入探讨如何在装配体环境中,利用参数化… · 2026/9/23 15:54:04

长垣有没有办电工证的,真实经历告诉你怎么考、怎么干、怎么赚
长垣有没有办电工证的,真实经历告诉你怎么考、怎么干、怎么赚

长垣有没有办电工证的,真实经历告诉你怎么考、怎么干、怎么赚 学历不高怕报不上名,这事儿我懂,当年我就是个初中毕业的,愣是考上了电工证,现在拿着证在工地干活,一个月也能挣七八千,说白了,只要你愿意学、愿意干,电工证这事儿真不难。… · 2026/11/21 12:26:27

哈尔滨电工证复审电话怎么查?网上查询全攻略来了
哈尔滨电工证复审电话怎么查?网上查询全攻略来了

哈尔滨电工证复审电话怎么查?网上查询全攻略来了 证书过期了不知道怎么复审延期?别急,哈尔滨电工证复审电话其实不难找,关键是你得知道怎么网上查询。如果你是电工,或是正在从事相关工作的朋友,这张证书不仅是职业资格的证明,更是上岗作业的“通行证”… · 2026/11/21 12:26:27

南京电工证焊工证电子证书过期怎么复审
南京电工证焊工证电子证书过期怎么复审

南京电工证焊工证电子证书过期怎么复审 证书过期了不知道怎么复审延期,这事儿不少电工、焊工都遇到过。很多人以为证书一过期就作废了,其实只要及时办理复审,照样能继续使用。特别是在南京地区,不少从业人员对【南京电工证焊工证】的电子证书流程并不熟悉… · 2026/11/21 12:26:27

东营去哪里考电工证好 电工证怎么考才能顺利通过网上查询
东营去哪里考电工证好 电工证怎么考才能顺利通过网上查询

东营去哪里考电工证好 电工证怎么考才能顺利通过网上查询 工地太忙根本没时间复习考试,这是很多一线电工的共同痛点。尤其是在东营,工地项目多、工期紧,很多人一边扛着活干,一边还得想着怎么去考电工证。网上查资料、找培训机构、报班学习,看似简单,其… · 2026/11/21 12:26:27

东营去哪里考电工证好?真实经历告诉你怎么避开坑
东营去哪里考电工证好?真实经历告诉你怎么避开坑

东营去哪里考电工证好?真实经历告诉你怎么避开坑 工地太忙根本没时间复习考试,这几乎是每个想考电工证的建筑工人心里的痛。尤其是像我这样刚来东营打工的新人,每天在工地搬砖、扛水泥,晚上还得加班,根本没有时间准备考试。我之前也是在网上乱搜“东营去… · 2026/11/21 12:26:27

临沂电工证怎样年审 你的证还能用吗 值不值得考
临沂电工证怎样年审 你的证还能用吗 值不值得考

临沂电工证怎样年审 你的证还能用吗 值不值得考 之前考的证在外省能不能转过来?这是很多电工朋友心里最担心的问题。临沂电工证怎样年审?很多人拿着证却不知道怎么操作,甚至担心过期失效。如果你正在纠结“值不值得考”,这篇文章给你一个清晰的解答。… · 2026/11/21 12:25:27

长春初级电工证怎么考?通过率揭秘全在这里
长春初级电工证怎么考?通过率揭秘全在这里

长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/20 16:18:19

国内电工证报考条件与考试时间
国内电工证报考条件与考试时间

低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/20 18:25:07

电工作业时如何断电?电子证书到底能不能全国通用?
电工作业时如何断电?电子证书到底能不能全国通用?

电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/20 17:56:32

电工证征求意见2026河南最新政策怎么应对?学历不高也能考!
电工证征求意见2026河南最新政策怎么应对?学历不高也能考!

电工证征求意见2026河南最新政策怎么应对?学历不高也能考! 你是不是也担心自己学历不高, 怕报不上名 ?尤其是像焦作水利工程这样的从业者,常年在一线作业,但证书却成了晋升、转岗、接项目的关键门槛。 2026河南最新政策… · 2026/11/21 0:00:17

电工证征求意见怎么填?含金量高不高?济源电工朋友看过来
电工证征求意见怎么填?含金量高不高?济源电工朋友看过来

电工证征求意见怎么填?含金量高不高?济源电工朋友看过来 不知道去哪报名怕被中介坑,电工证征求意见填错了不仅白费钱,还可能影响后续考试和工作。最近很多济源的电工朋友都在问: 电工证征求意见怎么填… · 2026/11/21 0:00:17

房建企业特种工考前押题怎么找?别让培训费打了水漂
房建企业特种工考前押题怎么找?别让培训费打了水漂

房建企业特种工考前押题怎么找?别让培训费打了水漂 怕考不过白交培训费?房建企业特种工考试难度高、题型多,很多人报名后才发现没有合适的复习资料,最终考试落榜,白白浪费了时间和金钱。别担心,掌握【考前押题】的技巧,能让你事半功倍,顺利通过考试。… · 2026/11/21 0:00:17

双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:45

STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:54

DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:26:03

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码