HarmonyOS Next 长列表滑动到指定列表项动效实现案例

最新推荐文章于 2024-08-13 20:26:54 发布

蜀道山QAQ

最新推荐文章于 2024-08-13 20:26:54 发布

阅读量991

点赞数 23

分类专栏：鸿蒙鸿蒙实战案例文章标签： harmonyos 华为学习 android 鸿蒙系统鸿蒙

本文链接：https://blog.csdn.net/shudaoshanQAQ/article/details/136886484

版权

鸿蒙同时被 2 个专栏收录

631 篇文章 75 订阅

订阅专栏

鸿蒙实战案例

134 篇文章 10 订阅

订阅专栏

介绍

在长列表场景时，当用户在浏览过程中打断时，列表会从第一项开始重新加载，此时我们使用scrollToIndex跳转到某个列表项时，当开启smooth动效时，会对经过的所有item进行加载和布局计算，当大量加载item时会导致性能问题，影响用户体验。因此我们使用currentOffset方法获取并记录偏移量，然后使用scrollTo方法跳转到上次浏览记录功能，可以流畅滑动到上次列表的位置。

效果图预览

使用说明

进入页面，第一次点击跳转到上次浏览记录，由于第一次没有记录，所以滑动到固定1000vp的位置。
此时按钮变成跳转到顶部，再次点击按钮，列表滑动到顶部，并同时记录上一次的位置坐标。
此时按钮变回为跳转到上次浏览记录，点击按钮，观察到列表流畅滑动到上次浏览位置。

实现思路

本例涉及的关键特性和实现方案如下：

使用LazyForEach+cachedCount+@Reusable实现懒加载列表，并且缓存附近组件。源码参考ListSlideToHistory.ets和OneMoment.ets。

List({ space: ListConstants.LIST_SPACE, scroller: this.listScroller }) {
   LazyForEach(momentData, (moment: FriendMoment) => {
    ListItem() {
      OneMoment({ moment: moment })
    }
}, (moment: FriendMoment) => moment.id)
}
.cachedCount(this.cachedCountNumber)
.width($r('app.string.layout_100'))
.height($r('app.string.layout_100'))
.listDirection(Axis.Vertical)
.divider({
   strokeWidth: $r('app.integer.friends_page_divider_width'),
   color: $r('app.color.friends_page_divider_color'),
   startMargin: $r('app.integer.list_history_list_divider_margin'),
   endMargin: $r('app.integer.list_history_list_divider_margin')
})
.onScrollIndex((first: number) => {
   this.firstIndex = first;
})

在页面返回/退出等需要历史记录的地方，使用currentOffset方法来获取当前偏移量并存储到本地，本例在跳转到Top时将偏移量记录到成员变量historyOffset中。源码参考ListSlideToHistory.ets。
```
this.historyOffset = this.listScroller.currentOffset().yOffset;
```

在跳转时，使用scrollTo+animation动画实现列表滑动。源码参考ListSlideToHistory.ets。

this.listScroller.scrollTo({
  xOffset: 0,
  yOffset: this.historyOffset === 0 ? this.DEFAULT_OFFSET : this.historyOffset,
  animation: { duration: this.ANIMATION_DURATION, curve: Curve.LinearOutSlowIn }
})

高性能知识点

参考了长列表加载性能优化，使用了里面的LazyForEach+cacheCount+@Reusable实现长列表不卡顿滑动。
参考了Scroller，使用了currentOffset计算偏移量和scrollTo+animation动效流畅滑动来代替scrollToIndex，因为scrollToIndex在长列表场景开启smooth动效时会导致卡顿。

工程结构&模块类型

   listslidetohistory               // har包
   |---constants                    
   |   |---ListConstants            // 列表常量
   |---model                        
   |   |---BasicDataSource          // 列表LazyForEach数据类 + 图文数据类
   |---view             
   |   |---components            
   |   |   |---ImageText            // 图标+文字组件
   |   |   |---OneMoment            // 列表内图文混排组件
   |   |---ListSlideToHistory       // 附近的人列表

模块依赖

@ohos/routermodule(动态路由)

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

如果你是一名有经验的资深Android移动开发、Java开发、前端开发、对鸿蒙感兴趣以及转行人员，可以直接领取这份资料

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（HarmonyOS NEXT）最新学习路线

HarmonOS基础技能

HarmonOS就业必备技能
HarmonOS多媒体技术

鸿蒙NaPi组件进阶

HarmonOS高级技能

初识HarmonOS内核
实战就业级设备开发

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料