纯血鸿蒙APP实战开发——长列表滑动到指定列表项动效实现案例

原创

小帅聊鸿蒙

发布于 2025-01-16 14:08:20

1500

介绍

在长列表场景时，当用户在浏览过程中打断时，列表会从第一项开始重新加载，此时我们使用 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;

DD一下：`欢迎大家关注公众号<程序猿百晓生>，可以了解到以下内容：`

1.OpenHarmony开发基础
2.OpenHarmony北向开发环境搭建
3.鸿蒙南向开发环境的搭建
4.鸿蒙生态应用开发白皮书V2.0 & V3.0
5.鸿蒙开发面试真题（含参考答案） 
6.TypeScript入门学习手册
7.OpenHarmony 经典面试题(含参考答案)
8.OpenHarmony设备开发入门【最新版】
9.沉浸式剖析OpenHarmony源代码
10.系统定制指南
11.【OpenHarmony】Uboot 驱动加载流程
12.OpenHarmony构建系统--GN与子系统、部件、模块详解
13.ohos开机init启动流程
14.鸿蒙版性能优化指南
.......

在跳转时，使用scrollTo+animation动画实现列表滑动。

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

工程结构&模块类型

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