目标管理（案例）

news2025/5/24 16:15:43

介绍

img

本篇Codelab将介绍如何使用@State、@Prop、@Link、@Watch、@Provide、@Consume管理页面级变量的状态，实现对页面数据的增加、删除、修改。要求完成以下功能：

  1. 实现一个自定义弹窗，完成添加子目标的功能。
  2. 实现一个可编辑列表，可点击指定行展开调节工作目标进度，可多选、全选删除指定行。

相关概念

  • 页面状态管理：用于管理页面级变量的状态。
  • 自定义弹窗： 通过CustomDialogController类显示自定义弹窗。
  • List列表：列表包含一系列相同宽度的列表项。

完整示例

gitee源码地址

源码下载

目标管理（ArkTS）.zip

代码结构解读

本篇Codelab只对核心代码进行讲解，对于完整代码，我们会在源码下载或gitee中提供。

├──entry/src/main/ets                   // ArkTS代码区
│  ├──common
│  │  ├──constants
│  │  │  └──CommonConstants.ets         // 公共常量类
│  │  └──utils
│  │     ├──DateUtil.ets                // 获取格式化日期工具
│  │     └──Logger.ets                  // 日志打印工具类
│  ├──entryability
│  │  └──EntryAbility.ts                // 程序入口类
│  ├──pages
│  │  └──MainPage.ets                   // 主页面
│  ├──view
│  │  ├──TargetInformation.ets          // 整体目标详情自定义组件
│  │  ├──AddTargetDialog.ets            // 自定义弹窗
│  │  ├──ProgressEditPanel.ets          // 进展调节自定义组件
│  │  ├──TargetList.ets                 // 工作目标列表
│  │  └──TargetListItem.ets             // 工作目标列表子项
│  └──viewmodel
│     └──DataModel.ets                  // 工作目标数据操作类
└──entry/src/main/resources	        // 资源文件目录

构建主界面

img

MainPage作为本应用的主界面，从上至下由三个自定义组件组成。

  1. 标题titleBar。
  2. 目标整体进展详情TargetInformation。
  3. 子目标列表TargetList。

MainPage主要维护五个参数：子目标数组targetData、子目标总数totalTasksNumber、已完成子目标数completedTasksNumber、最近更新时间latestUpdateDate、监听数据变化的参数overAllProgressChanged。具体作用有以下三个方面：

  1. 子组件TargetInformation接收三个参数totalTasksNumber、completedTasksNumber、latestUpdateDate，渲染整体目标详情。
  2. 子组件TargetList接收参数targetData渲染列表。
  3. 使用@Watch监听overAllProgressChanged的变化。当overAllProgressChanged改变时，回调onProgressChanged方法，刷新整体进展TargetInformation。
// MainPage.ets
@Entry
@Component
struct MainPage {
  // 子目标数组
  @State targetData: Array<TaskItemBean> = DataModel.getData();
  // 子目标总数
  @State totalTasksNumber: number = 0;
  // 已完成子目标数
  @State completedTasksNumber: number = 0;
  // 最近更新时间
  @State latestUpdateDate: string = CommonConstants.DEFAULT_PROGRESS_VALUE;
  // 监听数据变化的参数
  @Provide @Watch('onProgressChanged') overAllProgressChanged: boolean = false;		
  ...

  /**
   * overAllProgressChanged改变时的回调
   */
  onProgressChanged() {
    this.totalTasksNumber = this.targetData.length;
    this.completedTasksNumber = this.targetData.filter((item: TaskItemBean) => {
      return item.progressValue === CommonConstants.SLIDER_MAX_VALUE;
    }).length;
    this.latestUpdateDate = getCurrentTime();
  }

  build() {
    Column() {
      // 标题
      this.titleBar()
      // 目标整体进展详情
      TargetInformation({
        latestUpdateDate: this.latestUpdateDate,
        totalTasksNumber: this.totalTasksNumber,
        completedTasksNumber: this.completedTasksNumber
      })
      // 子目标列表
      TargetList({
        targetData: $targetData,
        onAddClick: (): void => this.dialogController.open()
      })
        ...
    }
    ...
  }

  @Builder
  titleBar() {
    Text($r('app.string.title'))
      ...
  }
}

添加任务子目标

img

本章节主要介绍如何实现一个自定义弹窗，完成添加子目标的功能。效果如图所示：

在MainPage.ets中，创建dialogController对象控制弹窗隐显，传入自定义组件AddTargetDialog和点击确定的回调方法saveTask。

// MainPage.ets
@Entry
@Component
struct MainPage {
  dialogController: CustomDialogController = new CustomDialogController({
    builder: AddTargetDialog({
      onClickOk: (value: string): void => this.saveTask(value)
    }),
    alignment: DialogAlignment.Bottom,
    offset: {
      dx: CommonConstants.DIALOG_OFFSET_X,
      dy: $r('app.float.dialog_offset_y')
    },
    customStyle: true,
    autoCancel: false
  });
}

在AddTargetDialog.ets中，参数onClickOk为function类型，接收MainPage传入的saveTask方法。点击确定，调用onClickOk执行saveTask方法，关闭弹窗。

// AddTargetDialog .ets
@CustomDialog
export default struct AddTargetDialog {
  ...
  private controller?: CustomDialogController;
  onClickOk?: (value: string) => void;

  build() {
    Column() {
      ...
      TextInput({ placeholder: $r('app.string.input_target_name')})
        ...
        .onChange((value: string) => {
          this.subtaskName = value;
        })
      Blank()
      Row() {
        ...
        Button($r('app.string.confirm_button'))
          .dialogButtonStyle()
          .onClick(() => {
            if (this.onClickOk !== undefined) {
              this.onClickOk(this.subtaskName);
            }
          })
      }
      ...
    }
    ...
  }
}

在MainPage.ets中，实现saveTask方法：保存数据至DataModel中，并更新targetData的值，完成添加子目标功能。

// MainPage.ets
@Entry
@Component
struct MainPage {
  ...
  saveTask(taskName: string) {
    if (taskName === '') {
      promptAction.showToast({
        message: $r('app.string.cannot_input_empty'),
        duration: CommonConstants.TOAST_TIME,
        bottom: CommonConstants.TOAST_MARGIN_BOTTOM
      });
      return;
    }
    // 保存数据
    DataModel.addData(new TaskItemBean(taskName, 0, getCurrentTime()));
    // 更新targetData刷新页面
    this.targetData = DataModel.getData();
    this.overAllProgressChanged = !this.overAllProgressChanged;
    this.dialogController.close();
  }
}

实现可编辑列表

img

本章节主要介绍子目标列表TargetList的实现，包括以下功能：

  • 列表项展开。
  • 列表子项点击下拉，滑动滑块更新进展。
  • 列表进入编辑状态，单选、多选、全选、删除子项。

6.1 实现列表项展开

实现以下步骤完成点击列表项展开功能：

  1. 使用@State 管理参数isExpanded，表示当前项是否展开，具体表现为自定义组件ProgressEditPanel的显示或隐藏。
  2. 使用@Link和@Watch管理参数clickIndex，表示当前点击ListItem的Index索引。clickIndex值的改变将会传递至所有的ListItem。
  3. 完成onClick点击事件，将isExpanded 值置反，修改clickIndex值为当前点击的索引。
// TargetListItem.ets
@Component
export default struct TargetListItem {
  @State latestProgress?: number = 0;
  @Link @Watch('onClickIndexChanged') clickIndex: number;
  @State isExpanded: boolean = false;
  ...
  // clickIndex改变的回调方法
  onClickIndexChanged() {
    if (this.clickIndex !== this.index) {
      this.isExpanded = false;
    }
  }

  build() {
    ...
    Column() {
      this.TargetItem()
      if (this.isExpanded) {
        Blank()
        // 自定义组件：编辑面板
        ProgressEditPanel({
          slidingProgress: this.latestProgress,
          onCancel: () => this.isExpanded = false,
          onClickOK: (progress: number): void => {
            this.latestProgress = progress;
            this.updateDate = getCurrentTime();
            let result = DataModel.updateProgress(this.index, this.latestProgress, this.updateDate);
            if (result) {
              this.overAllProgressChanged = !this.overAllProgressChanged;
            }
            this.isExpanded = false;
          },
          sliderMode: $sliderMode
        })
        ...
      }  
    }
    ...
    .onClick(() => {
      ...
      if (!this.isEditMode) {
        animateTo({ duration: CommonConstants.DURATION }, () => {
          this.isExpanded = !this.isExpanded;
        })
        this.clickIndex = this.index;
      }
    })
  }
  ...
}

6.2 实现更新进展

列表某项被展开后，实现以下步骤完成更新进展功能：

  1. Slider实现滑动条，滑动滑块调节进展，使用slidingProgress保存滑动值。
  2. 点击确定调用onClickOK方法，将数据slidingProgress回调至TargetListItem。
  3. 在TargetListItem中获取回调的数据并刷新页面。
// ProgressEditPanel.ets
@Component
export default struct ProgressEditPanel {
  @Prop slidingProgress: number = 0;
  onCancel?: () => void;
  onClickOK?: (progress: number) => void;

  build() {
    Column() {
      Slider({...})
      Row() {
        CustomButton({
          buttonText: $r('app.string.cancel_button')
        })
          .onClick(() => {
            if (this.onCancel !== undefined) {
              this.onCancel();
            }
          })
        CustomButton({
          buttonText: $r('app.string.confirm_button')
        })
          .onClick(() => {
            if (this.onClickOK !== undefined) {
              this.onClickOK(this.slidingProgress);
            }
          })
      }
    }
  }
}

在TargetListItem.ets中，完成onClickOK方法的实现，将依次完成以下步骤。

  1. 重新渲染TargetListItem的进度值和最近更新时间。
  2. 更新缓存的数据。
  3. 修改overAllProgressChanged的值，通知主页刷新整体进展详情TargetInformation。
// TargetListItem.ets
@Component
export default struct TargetListItem {
  ...
  build() {
  ...
    Column() {
      ...
      if (this.isExpanded) {
        Blank()
        // 自定义组件：编辑面板
        ProgressEditPanel({
          ...
          onClickOK: (progress: number): void => {
            this.latestProgress = progress;
            this.updateDate = getCurrentTime();
            let result = DataModel.updateProgress(this.index, this.latestProgress, this.updateDate);
            if (result) {
              this.overAllProgressChanged = !this.overAllProgressChanged;
            }
            this.isExpanded = false;
          },
          ...
        })
        ...
      }  
    }
  }
}

6.3 实现列表多选

列表进入编辑模式才可单选、多选。实现以下步骤完成列表多选功能：

  1. 维护一个boolean类型的数组selectArray，其长度始终与数据列表的长度相等，且初始值均为false。表示进入编辑状态时列表均未选中。
  2. 定义一个boolean类型的值isEditMode，表示是否进入了编辑模式。
  3. TargetListItem选中状态的初始化和点击Checkbox改变TargetListItem的选中状态。
// TargetList.ets
export default struct TargetList {
  ...
  @State isEditMode: boolean = false;
  @State selectArray: Array<boolean> = [];
  ...

  build() {
    Column() {
      ...
      if (this.isEditMode) {
        // 取消按钮
        Text($r('app.string.cancel_button'))
          ...
          .onClick(() => {
            ...
            this.isEditMode = false;
            this.selectAllOrCancel(false);
          })
        ...
        // 全选按钮
        Checkbox()
          ...
          .onClick(() => {
            ...
            this.selectAllOrCancel(this.selectAll);
          })
      } else {
        // 编辑按钮
        Text($r('app.string.edit_button'))
          ...
          .onClick(() => {
            this.isEditMode = true;
            this.selectAllOrCancel(false);
          })
      }
      ...
    }
  }
}

点击全选Checkbox，将selectArray数组的值全赋值true或false，重新渲染列表为全选或者取消全选状态。

// TargetList.ets
export default struct TargetList {
  ...
  selectAllOrCancel(selectStatus: boolean) {
    let newSelectArray: Array<boolean> = [];
    this.targetData.forEach(() => {
      newSelectArray.push(selectStatus);
    });
    this.selectArray = newSelectArray;
  }
}

在TargetListItem中，实现以下步骤改变ListItem的选中状态：

  1. 使用@Link定义selectArr数组接收TargetList传入的selectArray。
  2. 在TargetListItem渲染时，使用this.selectArr[this.index]获取初始选中状态。
  3. 点击Checkbox时，按照当前ListItem的索引，将选中状态保存至selectArr，重新渲染列表完成单选和多选功能
// TargetListItem.ets
export default struct TargetListItem {

  ...
  @Link selectArr: Array<boolean>;
  public index: number = 0;
  
  build() {
    Stack({ alignContent: Alignment.Start }) {
      ...
      this.TargetItem()
      ...
      Checkbox()
        // 获取初始选中状态
        .select(this.selectArr[this.index])
        ...
        .onChange((isCheck: boolean) => {
          // 改变被点击项的选中状态
          this.selectArr[this.index] = isCheck;
        })
      ...
    ...
    }
  }
}

6.4 实现删除选中列表项

当点击“删除”时，调用TargetList.ets的deleteSelected方法，实现以下步骤完成列表项删除功能：

  1. 调用DataModel的deleteData方法删除数据。
  2. 更新targetData的数据重新渲染列表。
  3. 修改overAllProgressChanged的值，通知主页刷新整体进展详情TargetInformation。
// TargetList.ets
export default struct TargetList {
  ...
  deleteSelected() {
    // 删除数据
    DataModel.deleteData(this.selectArray);
    // 更新targetData
    this.targetData = DataModel.getData();
    // 刷新整体进展详情
    this.overAllProgressChanged = !this.overAllProgressChanged;
    // 退出编辑模式
    this.isEditMode = false;
  }
}

在DataModel.ets中，遍历数据列表，删除被选中的数据项。

// DataModel.ets
export class DataModel {
  ...
  // 删除选中的数据
  deleteData(selectArr: Array<boolean>) {
    if (!selectArr) {
      Logger.error(TAG, 'Failed to delete data because selectArr is ' + selectArr);
    }
    let dataLen = this.targetData.length - CommonConstants.ONE_TASK;
    for (let i = dataLen; i >= 0; i--) {
      if (selectArr[i]) {
        this.recordData.splice(i, CommonConstants.ONE_TASK);
      }
    }
  }
  ...
}

总结

您已经完成了本次Codelab的学习，并了解到以下知识点：

  1. @State、@Prop、@Link、@Watch、@Provide、@Consume的使用。
  2. List组件的使用。
  3. 自定义弹窗的使用。
  4. Slider组件的使用。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/1355814.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

JUC AQS（AbstractQueuedSynchronizer）

JUC AQS（AbstractQueuedSynchronizer）

文章目录 AQS &#xff08;AbstractQueuedSynchronizer^1.5^&#xff09;CLH 锁队列AbstractQueuedSynchronizer 成员变量说明AbstractQueuedSynchronizer.Node 源码CLH 队列原理图入队逻辑方法出队逻辑方法 继承 AQS 需要实现的几个方法AQS 对象序列化ReentrantLock 源码解析R…
阅读更多...
Day7 vitest 之 vitest配置第三版

Day7 vitest 之 vitest配置第三版

项目目录 runner Type: VitestRunnerConstructor Default: node, 当运行test的时候 benchmark,当运行bench测试的时候 功能 自定义测试运行程序的路径。 要求 应与自定义库运行程序一起使用。 如果您只是运行测试&#xff0c;则可能不需要这个。它主要由library作者使用 …
阅读更多...
kubernetes(K8s)的使用和常用命令

kubernetes(K8s)的使用和常用命令

K8S kubernetes&#xff0c;由于k和s之间有8个字符&#xff0c;所以简称k8s&#xff0c;是一个全新的基于容器技术的分布式架构领先方案&#xff0c;是谷歌严格保密十几年的秘密武器----Borg系统的一个开源版本&#xff0c;于2015年7月发布第一个正式版本&#xff0c;它的本质…
阅读更多...
HTML如何设置多图片上传，并限制格式类型

HTML如何设置多图片上传，并限制格式类型

在HTML如何设置多图片上传&#xff0c;并限制格式类型为jpg和png格式。 <input type"file" name"fileInput" id"fileInput"> 上面这行代码&#xff0c;只支持单个文件上传&#xff0c;且不支持文件类型过滤&#xff0c;在实际开发过程中&…
阅读更多...
HTML5+CSS3+Vue小实例：彩色圆环溶解加载动画

HTML5+CSS3+Vue小实例：彩色圆环溶解加载动画

实例：彩色圆环溶解加载动画 技术栈：HTML+CSS+Vue.js 效果： 源码： 【HTML】 <!DOCTYPE html> <html lang="zh-CN"> <head><meta charset="UTF-8"><meta http-equiv="X-UA-Compatible" content="IE=edge&…
阅读更多...
「HarmonyOS」验证码多TextInput输入框焦点自动跳转问题

「HarmonyOS」验证码多TextInput输入框焦点自动跳转问题

需求背景&#xff1a;需要做一个多输入框的验证码模块&#xff0c;输入验证码时输入后光标会自动跳转至下一个输入框&#xff0c;删除验证码时会自动删除上一个输入框内容&#xff0c;并且光标跳转至上一个输入框内。6位验证码全部输完后进行登录请求 具体样式如下图&#xff1…
阅读更多...
RFID数据中心智能资产管理系统

RFID数据中心智能资产管理系统

数据中心机房承担着保障企业关键数据处理的重要责任&#xff0c;机房的日常管理直接关系到整体机房的日常维护和运行安全&#xff0c;数据资产管理中心在监管机房各部分设备的运行情况、维护数据中心的资产方面发挥着重要的作用。 成功的数据中心机房管理不仅需要选择高可靠性…
阅读更多...
理解UML中的依赖关系

理解UML中的依赖关系

理解UML中的依赖关系 在面向对象的设计中&#xff0c;理解各种类之间的关系对于构建一个清晰、可维护的系统至关重要。UML&#xff08;统一建模语言&#xff09;为我们提供了一种可视化这些关系的方式。今天&#xff0c;我们将深入探讨UML中的依赖关系&#xff08;Dependency&a…
阅读更多...
Kubernetes 核心实战之一（精华篇 1/2）

Kubernetes 核心实战之一（精华篇 1/2）

文章目录 1&#xff0c;资源创建方式1.1 yaml1.2 命令行 2&#xff0c;NameSpace命名空间2.1 命令行创建ns2.2 yaml 创建ns 3&#xff0c;Pod3.1 命令行 创建pod3.2 yaml 创建pod3.3 可视化界面 创建3.3.1 Pod nginx3.3.2 Pod nginx tomcat3.3.3 Pod 2ngnix 1&#xff0c;资源…
阅读更多...
ThreadLocal线程重用导致用户信息错乱的 Bug

ThreadLocal线程重用导致用户信息错乱的 Bug

在生产上遇到一个诡异的问题&#xff0c;有时获取到的用户信息是别人的。查看代码后&#xff0c;我发现他使用了 ThreadLocal 来缓存获取到的用户信息。 我们知道&#xff0c;ThreadLocal 适用于变量在线程间隔离&#xff0c;而在方法或类间共享的场景。如果用户信息的获取比较…
阅读更多...
软件测试第二部分：白盒测试

软件测试第二部分：白盒测试

概念与定义 白盒测试&#xff1a;侧重于系统或部件内部机制的测试&#xff0c;类型分为分支测试&#xff08;判定节点测试&#xff09;、路径测试、语句测试。 控制流分析(基于程序结构)&#xff1a;控制流分析是一类用于分析程序控制流结构的静态分析技术&#xff0c;目的在于…
阅读更多...
8个流行的Python可视化工具包，你喜欢哪个？

8个流行的Python可视化工具包，你喜欢哪个？

用 Python 创建图形的方法有很多&#xff0c;但是哪种方法是最好的呢&#xff1f;当我们做可视化之前&#xff0c;要先明确一些关于图像目标的问题&#xff1a;你是想初步了解数据的分布情况&#xff1f;想展示时给人们留下深刻印象&#xff1f;也许你想给某人展示一个内在的形…
阅读更多...
芯课堂 | LVGL基础知识（二）

芯课堂 | LVGL基础知识（二）

引言 在 LVGL 中&#xff0c;用户界面的基本构建块是对象&#xff0c;也称为小部件(widget)。默认情况下&#xff0c;LVGL在背景上绘制旧对象&#xff0c;在前景上绘制新对象。 对象层级(Layers) 创建对象层级顺序 默认情况下&#xff0c;LVGL在背景上绘制旧对象&#xff0c…
阅读更多...
【导出与导入Virtualbox虚拟机和启动连接openGauss数据库】

【导出与导入Virtualbox虚拟机和启动连接openGauss数据库】

【导出与导入Virtualbox虚拟机和启动连接openGauss数据库】 一、导出虚拟机二、导入虚拟机三、启动数据库四、使用Data Studio连接数据库 一、导出虚拟机 选择关机状态的虚拟机 -> 管理菜单 -> 导出虚拟电脑 点击完成后&#xff0c;需要等待一小段时间&#xff0c;如…
阅读更多...
基于gitlab 12.8.0版本的完整镜像过程

基于gitlab 12.8.0版本的完整镜像过程

目前已在一台服务器上安装了gitlab 12.8.0&#xff0c;并且稳定运行了有几年了&#xff0c;其上面也创建了大量的项目。目前要求对该gitlab及其上面的所有仓库做一个完整的镜像。具体操作过程如下&#xff1a; 1、确认现有的gitlab的版本号 2、到gitlab官网下载相同版本号的gi…
阅读更多...
【干货】Windows中定时删除system32目录下的.dmp文件教程

【干货】Windows中定时删除system32目录下的.dmp文件教程

旭帆科技的技术人员除了给用户答疑解惑以外&#xff0c;还会主动测试软件性能&#xff0c;进行平台优化&#xff0c;除此之外&#xff0c;技术人员还会总结一些技术干货&#xff0c;这不&#xff0c;近期又提供了一份如何在Windows中定时删除system32目录下的.dmp文件的教程。感…
阅读更多...
目标检测COCO数据集与评价体系mAP

目标检测COCO数据集与评价体系mAP

1.mAP 2.IoU IoU也就是交并比&#xff0c;也称为 Jaccard 指数&#xff0c;用于计算真实边界框与预测边界框之间的重叠程度。它是真值框与预测边界框的交集和并集之间的比值。Ground Truth边界框是测试集中手工标记的边界框&#xff0c;用于指定对象图像的位置以及预测的边界框…
阅读更多...
软件安全测试有哪些测试方法?安全测试报告如何申请?

软件安全测试有哪些测试方法?安全测试报告如何申请?

随着网络条件越来越好&#xff0c;软件产品质量和软件安全处于同等重要的地位&#xff0c;一款好的软件产品安全系数至关重要&#xff0c;因此安全测试必不可少&#xff0c;那么软件安全测试有哪些测试方法呢?安全测试报告又该如何申请&#xff1f; 软件安全测试是指测试人员…
阅读更多...
BUUCTF--ciscn_2019_n_31

BUUCTF--ciscn_2019_n_31

这是一题32位的堆题&#xff0c;照常看看保护&#xff1a; 没有开启PIE&#xff0c;接着进行黑盒测试&#xff1a; 菜单题&#xff0c;扔进IDA看看代码逻辑&#xff1a; 4这个功能是提供所谓的进阶版&#xff0c;当时我测试的时候以为是里面有后门还是什么的。结果发现是虚晃一…
阅读更多...
（17）Linux的进程阻塞进程程序替换 exec 函数簇

（17）Linux的进程阻塞进程程序替换 exec 函数簇

前言&#xff1a;本章我们讲解它的 options 参数。在讲解之前我们需要理解进程阻塞&#xff0c;然后我们重点讲解二进程程序替换&#xff0c;这是本章的重点&#xff0c;然后介绍一个进程替换函数 execl&#xff0c;通过介绍这个函数来打开突破口&#xff0c;引入进程创建的知识…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023