目录

如何用Progress组件显示任务列表进度

问题现象

使用Progress进度条组件展示任务进度时出现问题:

  1. 总任务数5,已完成任务数3,此时删除一条已完成的任务,进度条先增长再减少。这个问题是什么原因导致的,如何解决?

    问题代码如下:

    @Entry
    @Component
    struct TaskListPage1 {
      @State finishedTask: number = 0; // 已完成任务数
      @State totalTask: number = 0; // 总任务数
      @State tasks: TaskInfo[] = []; // 任务列表
      @State deleteButtonBgcolor: string | Color = '#E84026'; // 删除按钮的颜色
    
    
      // 删除任务按钮
      @Builder
      DeleteTask(index: number) {
        Stack() {
          Image($r('app.media.ic_public_trash')) // 删除图标,可以更换其他资源
            .draggable(false)
            .width(20);
        }
        .width(40)
        .height(40)
        .borderRadius('50%')
        .margin({ left: 16 })
        .backgroundColor(this.deleteButtonBgcolor)
        .onTouch((event?: TouchEvent) => {
          if (event) {
            if (event.type === TouchType.Down) {
              this.deleteButtonBgcolor = '#AAE84026'; // 按下时图标背景颜色
            } else if (event.type === TouchType.Up || event.type === TouchType.Cancel) {
              this.deleteButtonBgcolor = '#E84026'; // 取消或抬起恢复图标背景颜色
            }
          }
        })
        .onClick(() => {
          this.tasks.splice(index, 1); // 任务列表删除当前索引的任务
          this.finishedTask = this.tasks.filter((item): boolean => item.isFinished).length; // 重新获取已完成任务数
          this.totalTask = this.tasks.length; // 获取总任务数
        });
      }
    
    
      build() {
        Column() {
          // 任务进度以及新增任务按钮
          TaskProgress({ finishedTask: this.finishedTask, totalTask: this.totalTask, tasks: this.tasks }).margin(16);
          // 任务列表
          List({ space: 8 }) {
            ForEach(this.tasks, (item: TaskInfo, index: number) => {
              ListItem() {
                TaskItem({ item: item, finishedTask: this.finishedTask, tasks: this.tasks });
              }.padding({ left: 16, right: 16 })
              .swipeAction({ end: this.DeleteTask(index), edgeEffect: SwipeEdgeEffect.None }); // 左滑出现删除按钮
            });
          }
          .layoutWeight(1)
          .width('100%')
          .scrollBar(BarState.Off);
        }
        .height('100%')
        .width('100%')
        .backgroundColor('#f1f3f5')
        .expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP, SafeAreaEdge.BOTTOM]);
      }
    }
    
    
    // 任务进度组件
    @Component
    export struct TaskProgress {
      @Link finishedTask: number;
      @Link totalTask: number;
      @Link tasks: TaskInfo[];
      taskId: number = 0;
    
    
      build() {
        Column({ space: 20 }) {
          Row() {
            Text('任务进度:')
              .fontSize(25)
              .fontWeight(FontWeight.Bold);
            // 使用Stack堆叠容器,将进度条和进度展示层叠显示
            Stack() {
              // Start solution1
              Progress({
                value: this.finishedTask, // 进度值,已完成数
                total: this.totalTask, // 进度总长,总任务数
                type: ProgressType.Ring, // 环形
              }).width(90);
              // End solution1
              Text(`${this.finishedTask} / ${this.totalTask}`).fontSize(25);
            };
          }
          .borderRadius(10)
          .height(110)
          .justifyContent(FlexAlign.Center)
          .backgroundColor(Color.White)
          .width('100%');
    
    
          Button('新增任务')
            .width('60%')
            .onClick(() => {
              this.tasks.push(new TaskInfo(this.taskId++, false));
              this.totalTask = this.tasks.length;
            });
        }.width('100%');
      }
    }
    
    
    // 任务项组件
    @Component
    export struct TaskItem {
      @State item: TaskInfo = new TaskInfo(0, false);
      @Link finishedTask: number;
      @Link tasks: TaskInfo[];
    
    
      build() {
        Row() {
          Text(`ID:${this.item.id}`).fontSize(16);
          Checkbox()
            .width(30)
            .shape(CheckBoxShape.CIRCLE)
            .select(this.item.isFinished)
            .onClick(() => {
              if (this.item.isFinished === true) {
                this.finishedTask--;
              } else {
                this.finishedTask++;
              }
              this.item.isFinished = !this.item.isFinished;
            });
        }
        .justifyContent(FlexAlign.SpaceBetween)
        .borderRadius(20)
        .padding({ left: 20, right: 20 })
        .backgroundColor(Color.White)
        .height(56)
        .width('100%');
      }
    }
    
    
    // 任务信息,id和完成情况
    export class TaskInfo {
      id: number;
      isFinished: boolean;
    
    
      constructor(id: number, isFinished: boolean) {
        this.id = id;
        this.isFinished = isFinished;
      }
    }

    现象效果图如下:

  2. 在问题一的场景中,删除任务后,如何实现进度条从0平滑增长到当前进度的动画效果?

背景知识

Progress是进度条显示组件,显示内容为目标操作的当前进度。当进度条组件的样式style中enableSmoothEffect设置为true时(默认为true),表示开启平滑动效,进度值value变化时会产生动画效果。

解决方案

常见FAQ

Q:Progress组件显示完成进度时,如何不展示动画?

A:可以将Progress组件style中enableSmoothEffect设置为false,关闭进度值变化时的动效。

总结

默认情况下Progress组件修改进度值value会触发动画效果,修改进度总长total会直接渲染。如果在未关闭进度平滑动效时修改total和value,会出现预期外的视觉表现(如进度先增后减)。建议设置total值为100,通过进度完成情况百分比计算value更新进度值,避免直接修改total。