鸿蒙HarmonyOS 5.0开发实战：网格元素交换实现案例

 往期鸿蒙5.0全套实战文章必看：（文中附带鸿蒙5.0全栈学习资料）

• 鸿蒙开发核心知识点，看这篇文章就够了
  
• 最新版！鸿蒙HarmonyOS Next应用开发实战学习路线
  
• 鸿蒙HarmonyOS NEXT开发技术最全学习路线指南
  
• 鸿蒙应用开发实战项目，看这一篇文章就够了（部分项目附源码）
  

---

介绍

直接进行交换和删除元素会给用户带来不好的体验效果，因此必要在此过程中注入一些特色的动画来提升体验效果，本案例通过Grid组件、attributeModifier、以 及animateTo函数实现了拖拽动画，删除动画和添加时的位移动画。
效果图预览

利用阐明：

• 进入页面，点击编辑，长按网格元素，实验拖拽操作，拖拽过程中表现此网格元素，拖拽到一定的位置时，会进行网格元素的位置交换。
  
• 编辑模式下，点击首页应用里的网格元素，此元素会被删除，下面对应元素右上角会出现添加标志。
  
• 编辑模式下，点击应用类别1/应用类别2里有添加标识的元素，该元素会移动到首页应用里。
  

实现思路

本示例主要通过attributeModifier、supportAnimation、animateTo等实现了删除动画以及长按拖拽动画。attributeModifier绑定自定义属性对象， 控制每个网格元素的属性更新。实验删除操作时，通过animateTo去更新offset值以及opacity等属性，实验添加操作时，通过animateTo去更新translate偏移量和visibility等属性。supportAnimation设置为true，支持GridItem 拖拽动画，在onItemDragStart开始拖拽网格元素时触发，onItemDragStart可以返回一个@Builder修饰的自定义组件，这样在拖拽的时间， 可以大概表现目的元素。onItemDrop在网格元素内停止拖拽时触发。此时实验元素位置的切换功能。

• 声明一个数组，添加自定义属性对象，每个自定义属性对象对应一个网格元素。
  

1. constructor(data: T[]) {
2.    this.gridData = data;
3.    data.forEach(() => {
4.      this.modifier.push(new GridItemModifier());
5.    })
6. }
7. /**
8. * 声明GridItem动态属性
9. */
10. @Observed
11. export class GridItemModifier implements AttributeModifier<GridItemAttribute> {
12.   public offsetX: number = 0;
13.   public offsetY: number = 0;
14.   public opacity: number = 1;
16.   /**
17.    * 定义组件普通状态时的样式
18.    * @param instance
19.    */
20.   applyNormalAttribute(instance: GridItemAttribute): void {
21.     instance.translate({ x: this.offsetX, y: this.offsetY });
22.     instance.opacity(this.opacity);
23.   }
24. }

复制代码

1. constructor(data: T[]) {
2.   this.sortAppData = data;
3.   data.forEach(() => {
4.     this.modifier.push(new TranslateItemModifier());
5.   })
6. }
8. /**
9. * 声明被添加的gridItem动态属性
10. */
11. @Observed
12. export class TranslateItemModifier extends AttributeUpdater<ColumnAttribute> {
13.   /**
14.    * 定义组件普通状态时的样式
15.    * @param instance
16.    */
17.   initializeModifier(instance: ColumnAttribute): void {
18.     instance.translate({ x: 0, y: 0 })
19.       .visibility(Visibility.Visible)
20.   }
21. }

复制代码

• 绑定attributeModifier属性，attributeModifier属性的值为对应的自定义属性对象。
  

1. GridItem() {
2.    IconWithNameView({ app: item })
3. }
4. .onAreaChange((oldValue: Area, newValue: Area) => {
5.    this.itemAreaWidth = Number(newValue.width);
6. })
7. .onTouch((event: TouchEvent) => {
8.    if (event.type === TouchType.Down) {
9.      this.movedItem = this.appInfoList[index];
10.    }
11. })
12. // TODO:知识点:动态绑定属性信息
13. .attributeModifier(this.GridItemDeletion.getModifier(item) ? this.GridItemDeletion.getModifier(item) : undefined)

复制代码

1. Column() {
2.   this.gridItemWithNameView({app: data.app, homeAppNames: data.homeAppNames});
3. }
4. // TODO:知识点:动态绑定属性信息
5. .attributeModifier(data.translateItemModifier.getModifier(data.app))

复制代码

• 编辑模式下点击网格元素，实验删除操作，删除过程中利用animateTo来更新元素的偏移量并实现动画效果。
  

1.   deleteGridItem(item: T, itemAreaWidth: number): number {
2.     const index: number = this.gridData.indexOf(item);
3.     if(index === -1){
4.        return index;
5.     }
6.     animateTo({
7.       curve: Curve.Friction, duration: ANIMATION_DURATION, onFinish: () => {
8.         // 初始化偏移位置
9.         this.modifier.forEach((item) => {
10.           item.offsetX = 0;
11.           item.offsetY = 0;
12.         })
13.         // 删除对应的数据
14.         this.gridData.splice(index, 1);
15.         this.modifier.splice(index, 1);
16.         this.status = DeletionStatus.FINISH;
17.         // 存储动画状态
18.         AppStorage.setOrCreate('deletionStatus', this.status);
19.       }
20.     }, () => {
21.       // TODO:知识点:实现删除动画。先让目标元素的opacity为0，不可视，直接删除目标元素会导致偏移的时候位置异常，接着遍历元素的属性对象，修改偏移量。
22.       this.modifier[index].opacity = 0;
23.       this.modifier.forEach((item: GridItemModifier, ind: number) => {
24.         // 最后一条数据不执行偏移
25.         if (index === this.gridData.length - 1) {
26.           this.status = DeletionStatus.START;
27.           return;
28.         }
29.         if (ind > index && ind % COLUMN_COUNT !== 0) {
30.           item.offsetX = -itemAreaWidth;
31.         } else if (ind > index && ind % COLUMN_COUNT === 0) {
32.           item.offsetX = itemAreaWidth * 4; // 位置偏移到上一行的最后一列，因此偏移4个gridItem所占的宽度
33.           item.offsetY = -GRID_ITEM_SIZE;
34.         }
35.       })
36.       this.status = DeletionStatus.START;
37.     })
38.     return index;
39.   }
40. }

复制代码

• 交换网格元素，onItemDragStart以及onItemDrop来完成元素的交换功能，supportAnimation设置为true，支持在拖拽时表现动画效果。onItemDragStart函数中 返回目的自定义组件，可以在拖拽过程中表现。onItemDrop函数实验末了网格元素的交换。 
  

1. .supportAnimation(true)
2. .editMode(this.isEdit)
3. .onItemDragStart((event: ItemDragInfo, itemIndex: number) => {
4.    // TODO:知识点:在onItemDragStart函数返回自定义组件，可在拖拽过程中显示此自定义组件。
5.    return this.pixelMapBuilder();
6. })
7. .onItemDrop((event: ItemDragInfo, itemIndex: number, insertIndex: number, isSuccess: boolean) => {
8.    // TODO:知识点:执行gridItem切换操作
9.    if (isSuccess && insertIndex < this.appInfoList.length) {
10.      this.changeIndex(itemIndex, insertIndex);
11.    }
12. })

复制代码

• 编辑模式下，点击有添加标识的网格元素，将其添加到首页应用中，删除过程中利用animateTo来更新元素的偏移量并实现动画效果。
  

1. addGridItem(item: T, appInfoList: AppInfo[]): void {
2.   const index: number = this.sortAppData.indexOf(item);
3.   const appId: string = (item as AppInfo).name.toString();
4.   animateTo({
5.     curve: Curve.Linear, duration: ANIMATION_DURATION, onFinish: () => {
6.       this.modifier[index].attribute?.visibility(Visibility.Hidden);
7.       // 初始化modifier所有属性
8.       this.modifier.forEach((item) => {
9.         item.attribute?.translate({ x: 0, y: 0 }).visibility(Visibility.Visible);
10.       })
11.       this.status = AddStatus.FINISH;
12.       // 存储动画状态
13.       AppStorage.setOrCreate('addStatus', this.status);
14.     }
15.   }, () => {
16.     let offsetX: number = 0;
17.     let offsetY: number = 0;
19.     // 首页应用里的gridItem个数
20.     const gridItemNumber: number = appInfoList.length;
21.     // 首页应用里的gridItem个数除列数的余数
22.     const homeAppIndex: number = gridItemNumber % COLUMN_COUNT;
23.     // 被点击应用的坐标信息
24.     const componentInfo: componentUtils.ComponentInfo = componentUtils.getRectangleById(appId);
25.     // 余数也是被点击应用移动的终点位置的索引号，两者索引号相减，再乘gridItem本身的宽度，就是横向移动的距离
26.     offsetX = (homeAppIndex - index) * GRID_ITEM_SIZE;
27.     // 首页应用里的个数为0
28.     if (appInfoList.length === 0) {
29.       // 用首页应用的第一个app的y轴坐标减去被点击应用的y轴坐标即可计算出y轴偏移量
30.       offsetY = FIRST_APP_SCREEN_OFFSET_Y - componentInfo.screenOffset.y;
31.       this.modifier[index].attribute?.translate({ x: offsetX, y: px2vp(offsetY) });
32.       this.status = AddStatus.START;
33.       return;
34.     }
35.     // 首页应用里最后一个gridItem的坐标信息
36.     const lastAppComponentInfo: componentUtils.ComponentInfo =
37.       componentUtils.getRectangleById(`${appInfoList[appInfoList.length - 1].name.toString()}InHome`);
39.     if (homeAppIndex === 0) {
40.       // 余数等于0，说明gridItem要移动到一行的第一个，y轴移动距离要加上girItem本身的高度
41.       offsetY = lastAppComponentInfo.screenOffset.y - componentInfo.screenOffset.y + lastAppComponentInfo.size.height;
42.     } else {
43.       // 余数不等于0，直接使用两者的y轴坐标相减即可得到移动距离
44.       offsetY = lastAppComponentInfo.screenOffset.y - componentInfo.screenOffset.y;
45.     }
46.     this.modifier[index].attribute?.translate({ x: offsetX, y: px2vp(offsetY) });
47.     this.status = AddStatus.START;
48.   })
49. }

复制代码

高性能知识点

• 动态加载数据场景可以利用LazyForEach遍历数据。
  
• onAreaChange 在区域发生大小变化的时间会进行调用，由于删除操作或者网格元素的交互都可以大概触发区域函数的利用，操作频仍， 建议此处镌汰日记的打印、复用函数逻辑来降低性能的内耗。
  
• onTouch 在进行手势操作的时间会进行多次调用，建议此处镌汰日记的打印、复用函数逻辑来降低性能的内耗。
  
• Flex 利用了flex布局会对应勤奋耗产生较大影响，请结合实际情况审慎利用。
  

工程布局&模块类型

1. gridexchange                                 // har类型
2. |---model
3. |   |---AppInfo.ets                          // App信息
4. |   |---AttributeModifier.ets                // 属性对象
5. |   |---GridItemDeletionCtrl.ets             // 列表项交换
6. |   |---MockData.ets                         // 模拟数据
7. |---view
8. |   |---GridExchange.ets                     // 视图层-应用主页面

复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。