目录

LazyForEach渲染的List列表上滑触发刷新动画

问题现象

使用LazyForEach渲染List列表,实现下滑会触发transition动画,但是上滑也会触发动画,如何使其上滑过程中不会触发动画?

问题示意图:

背景知识

问题定位

当在滚动容器中使用了LazyForEach,框架会根据滚动容器可视区域按需创建组件,当组件滑出可视区域外时,框架会进行组件销毁回收以降低内存占用,因此当List往下滑动,滚动出可视区域的列表项就会被销毁回收,当再往上回到顶部时,实际上会重新创建列表项,就会出现上滑过程中触发刷新动画。

分析结论

LazyForEach回收列表项子组件导致重新渲染而触发上滑时的刷新动画。

解决方案

可以根据滑动方向决定是否展示动画,来达到下滑不会触发动画的效果,具体实现为:

  1. 实现LazyForEach数据源相关接口,使用BasicDataSource类实现IDataSource接口,负责管理数据变化的监听者和数据本身,可以参考官网BasicDataSource示例代码,并且使用MyDataSource类继承BasicDataSource类,增加自定义的方法,MyDataSource代码如下:
    class MyDataSource extends BasicDataSource {
      private dataArray: string[] = [];
    
      public totalCount(): number {
        return this.dataArray.length;
      }
    
      public getData(index: number): string {
        return this.dataArray[index];
      }
    
      public addData(index: number, data: string): void {
        this.dataArray.splice(index, 0, data);
        this.notifyDataAdd(index);
      }
    
      public pushData(data: string): void {
        this.dataArray.push(data);
        this.notifyDataAdd(this.dataArray.length - 1);
      }
    }
  2. 定义状态变量,创建数据源data。
    private data: MyDataSource = new MyDataSource();
    @State showItemAnimation: boolean = false;
    @State currentScrollOffsetInList: number = 0;
    private currentScrollStateInList: ScrollState | null = null;
    private lastOffset: number = 0;
  3. 在aboutToAppear生命周期方法中,初始化数据源,向其中添加50个数据项,每个数据项为字符串格式。
    aboutToAppear() {
      for (let i = 0; i <= 50; i++) {
        this.data.pushData(`Hello ${i}`);
      }
    }
  4. 使用LazyForEach来渲染列表项,每个列表项显示一个字符串,并且使用状态变量showItemAnimation决定是否添加动画效果,当showItemAnimation为true时,列表项会显示透明度和位置的动画效果。通过transition属性为列表项添加动画效果:使用TransitionEffect.OPACITY和TransitionEffect.move实现列表项的透明度和位置变化动画,并使用curves.springMotion,根据index调整延迟,实现类似弹簧动画效果。
    List({ space: 20, initialIndex: 0 }) {
      LazyForEach(this.data, (item: number, index: number) => {
        ListItem() {
          Text('' + item)
            .width('100%')
            .height(100)
            .fontSize(16)
            .textAlign(TextAlign.Center)
            .borderRadius(10)
            .backgroundColor(0xFFFFFF);
        }
        .transition(this.showItemAnimation ?
          TransitionEffect.OPACITY.combine(TransitionEffect.move(TransitionEdge.END))
            .animation({ curve: curves.springMotion(), duration: 300, delay: (index % 10) * 30 }) : null);
      }, (item: string) => item);
    }
  5. 使用onDidScroll监听列表的滚动事件,更新currentScrollOffsetInList和currentScrollStateInList状态。

    根据onDidScroll的参数scrollOffset的正负来决定是否显示动画效果,当滚动到顶部且之前滚动方向为向上时,不显示动画效果。

    .onDidScroll((scrollOffset: number, scrollState: ScrollState) => {
      this.currentScrollOffsetInList = scrollOffset;
      this.currentScrollStateInList = scrollState;
      if (scrollOffset != 0) {
        this.lastOffset = scrollOffset;
      }
      this.showItemAnimation = ((scrollOffset <= 0 && this.lastOffset < 0) ? false : true);
    })
完整示例代码如下:
import { curves } from '@kit.ArkUI';

class BasicDataSource implements IDataSource {
  private listeners: DataChangeListener[] = [];
  private originDataArray: string[] = [];

  public totalCount(): number {
    return this.originDataArray.length;
  }

  public getData(index: number): string {
    return this.originDataArray[index];
  }

  // 该方法为框架侧调用,为LazyForEach组件向其数据源处添加listener监听
  registerDataChangeListener(listener: DataChangeListener): void {
    if (this.listeners.indexOf(listener) < 0) {
      this.listeners.push(listener);
    }
  }

  // 该方法为框架侧调用,为对应的LazyForEach组件在数据源处去除listener监听
  unregisterDataChangeListener(listener: DataChangeListener): void {
    const pos = this.listeners.indexOf(listener);
    if (pos >= 0) {
      this.listeners.splice(pos, 1);
    }
  }

  // 通知LazyForEach组件需要重载所有子组件
  notifyDataReload(): void {
    this.listeners.forEach(listener => {
      listener.onDataReloaded();
    });
  }

  // 通知LazyForEach组件需要在index对应索引处添加子组件
  notifyDataAdd(index: number): void {
    this.listeners.forEach(listener => {
      listener.onDataAdd(index);
    });
  }

  // 通知LazyForEach组件在index对应索引处数据有变化,需要重建该子组件
  notifyDataChange(index: number): void {
    this.listeners.forEach(listener => {
      listener.onDataChange(index);
    });
  }

  // 通知LazyForEach组件需要在index对应索引处删除该子组件
  notifyDataDelete(index: number): void {
    this.listeners.forEach(listener => {
      listener.onDataDelete(index);
    });
  }

  // 通知LazyForEach组件将from索引和to索引处的子组件进行交换
  notifyDataMove(from: number, to: number): void {
    this.listeners.forEach(listener => {
      listener.onDataMove(from, to);
    });
  }

  notifyDatasetChange(operations: DataOperation[]): void {
    this.listeners.forEach(listener => {
      listener.onDatasetChange(operations);
    });
  }
}

class MyDataSource extends BasicDataSource {
  private dataArray: string[] = [];

  public totalCount(): number {
    return this.dataArray.length;
  }

  public getData(index: number): string {
    return this.dataArray[index];
  }

  public addData(index: number, data: string): void {
    this.dataArray.splice(index, 0, data);
    this.notifyDataAdd(index);
  }

  public pushData(data: string): void {
    this.dataArray.push(data);
    this.notifyDataAdd(this.dataArray.length - 1);
  }
}

@Entry
@Component
struct LazyForEachListTransition {
  private data: MyDataSource = new MyDataSource();
  @State showItemAnimation: boolean = false;
  @State currentScrollOffsetInList: number = 0;
  private currentScrollStateInList: ScrollState | null = null;
  private lastOffset: number = 0;

  aboutToAppear() {
    for (let i = 0; i <= 50; i++) {
      this.data.pushData(`Hello ${i}`);
    }
  }

  build() {
    Column() {
      List({ space: 20, initialIndex: 0 }) {
        LazyForEach(this.data, (item: number, index: number) => {
          ListItem() {
            Text('' + item)
              .width('100%')
              .height(100)
              .fontSize(16)
              .textAlign(TextAlign.Center)
              .borderRadius(10)
              .backgroundColor(0xFFFFFF);
          }
          .transition(this.showItemAnimation ?
          TransitionEffect.OPACITY.combine(TransitionEffect.move(TransitionEdge.END))
            .animation({ curve: curves.springMotion(), duration: 300, delay: (index % 10) * 30 }) : null);
        }, (item: string) => item);
      }
      .listDirection(Axis.Vertical) // 排列方向
      .scrollBar(BarState.Off)
      .friction(0.6)
      .divider({
        strokeWidth: 2,
        color: 0xFFFFFF,
        startMargin: 20,
        endMargin: 20
      }) // 每行之间的分界线
      .edgeEffect(EdgeEffect.Spring) // 边缘效果设置为Spring
      .onScrollIndex(() => {})
      .onDidScroll((scrollOffset: number, scrollState: ScrollState) => {
        this.currentScrollOffsetInList = scrollOffset;
        this.currentScrollStateInList = scrollState;
        if (scrollOffset != 0) {
          this.lastOffset = scrollOffset;
        }
        this.showItemAnimation = ((scrollOffset <= 0 && this.lastOffset < 0) ? false : true);
      })
      .width('90%');
    }
    .width('100%')
    .height('100%')
    .backgroundColor(0xDCDCDC)
    .padding({ top: 5 });
  }
}

修正效果如下:

总结

配合刷新动画的滚动组件在嵌套LazyForEach时,需注意LazyForEach的特性,控制相应的组件的动画效果不受LazyForEach影响,以免出现动画不正常刷新的情况。