往期鸿蒙5.0全套实战文章必看：（文中附带鸿蒙5.0全栈学习资料）
-
鸿蒙开发核心知识点，看这篇文章就够了
-
最新版！鸿蒙HarmonyOS Next应用开发实战学习路线
-
鸿蒙HarmonyOS NEXT开发技术最全学习路线指南
-
鸿蒙应用开发实战项目，看这一篇文章就够了（部分项目附源码）
长列表滑动到指定列表项动效实现案例
介绍
在长列表场景时，当用户在浏览过程中打断时，列表会从第一项开始重新加载，此时我们使用scrollToIndex跳转到某个列表项时，当开启smooth动效时，会对经过的所有item进行加载和布局计算，当大量加载item时会导致性能问题，影响用户体验。因此我们使用currentOffset方法获取并记录偏移量，然后使用scrollTo方法跳转到上次浏览记录功能，可以流畅滑动到上次列表的位置。
效果图预览
使用说明
- 进入页面，第一次点击跳转到上次浏览记录，由于第一次没有记录，所以滑动到固定1000vp的位置。
- 此时按钮变成跳转到顶部，再次点击按钮，列表滑动到顶部，并同时记录上一次的位置坐标。
- 此时按钮变回为跳转到上次浏览记录，点击按钮，观察到列表流畅滑动到上次浏览位置。
实现思路
本例涉及的关键特性和实现方案如下：
-
使用LazyForEach+cachedCount+@Reusable实现懒加载列表，并且缓存附近组件。
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.list_slide_to_history_layout_100')) .height($r('app.string.list_slide_to_history_layout_100')) .listDirection(Axis.Vertical) .divider({strokeWidth: $r('app.integer.list_slide_to_history_divider_width'),color: $r('app.color.list_slide_to_history_divider_color'),startMargin: $r('app.integer.list_slide_to_history_list_divider_margin'),endMargin: $r('app.integer.list_slide_to_history_list_divider_margin') }) .onScrollIndex((first: number) => {this.firstIndex = first; }) -
在页面返回/退出等需要历史记录的地方，使用currentOffset方法来获取当前偏移量并存储到本地，本例在跳转到Top时将偏移量记录到成员变量historyOffset中。
this.historyOffset = this.listScroller.currentOffset().yOffset; -
在跳转时，使用scrollTo+animation动画实现列表滑动。
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 // 附近的人列表
