鸿蒙应用开发(HarmonyOS)网格元素拖拽删除交换

[复制链接]
发表于 2025-11-23 21:05:22 | 显示全部楼层 |阅读模式
  鸿蒙NEXT开发实战往期必看文章:
一分钟相识”纯血版!鸿蒙HarmonyOS Next应用开发!
“非常详细的” 鸿蒙HarmonyOS Next应用开发学习门路!(从零根本入门到醒目)
HarmonyOS NEXT应用开发案例实践总联合(连续更新......)
HarmonyOS NEXT应用开发性能优化实践总结(连续更新......)

先容

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



利用阐明

  • 进入页面,点击编辑,长按网格元素,实验拖拽操纵,拖拽过程中体现此网格元素,拖拽到肯定的位置时,会举行网格元素的位置交换。
  • 编辑模式下,点击首页应用里的网格元素,此元素会被删除,下面对应元素右上角会出现添加标志。
  • 编辑模式下,点击应用种别1/应用种别2里有添加标识的元素,该元素会在首页应用里出现。
实现思绪

本示例重要通过attributeModifier、supportAnimation、animateTo等实现了删除动画以及长按拖拽动画。attributeModifier绑定自界说属性对象, 控制每个网格元素的属性更新。实验删除操纵时,通过animateTo去更新offset值以及opacity等属性。supportAnimation设置为true,支持GridItem 拖拽动画,在onItemDragStart开始拖拽网格元素时触发,onItemDragStart可以返回一个@Builder修饰的自界说组件,如许在拖拽的时间, 可以大概体现目标元素。onItemDrop在网格元素内制止拖拽时触发。此时实验元素位置的切换功能

  • 声明一个数组,添加自界说属性对象,每个自界说属性对象对应一个网格元素,源码参考AttributeModifier.ets和GridItemDeletionCtrl.ets。
  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;
  15.   /**
  16.    * 定义组件普通状态时的样式
  17.    * @param instance
  18.    */
  19.   applyNormalAttribute(instance: GridItemAttribute): void {
  20.     instance.translate({ x: this.offsetX, y: this.offsetY });
  21.     instance.opacity(this.opacity);
  22.   }
  23. }
复制代码

  • 绑定attributeModifier属性,attributeModifier属性的值为对应的自界说属性对象。源码参考GridExchange.ets。
  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)
复制代码

  • 编辑模式下点击网格元素,实验删除操纵,删除过程中利用animateTo来更新元素的偏移量并实现动画效果。源码参考GridItemDeletionCtrl.ets。
  1. deleteGridItem(item: T, itemAreaWidth: number): void {
  2.    const index: number = this.gridData.indexOf(item);
  3.    // 最后一条数据不执行偏移
  4.    if (index === this.gridData.length - 1) {
  5.      this.gridData.splice(index, 1);
  6.      this.modifier.splice(index, 1);
  7.      return;
  8.    }
  9.    // TODO:知识点:实现删除动画。先让目标元素的opacity为0,不可视,直接删除目标元素会导致偏移的时候位置异常,接着遍历元素的属性对象,修改偏移量。
  10.    this.modifier[index].opacity = 0;
  11.    animateTo({
  12.      curve: Curve.Friction, duration: ANIMATION_DURATION, onFinish: () => {
  13.        // 初始化偏移位置
  14.        this.modifier.forEach((item) => {
  15.          item.offsetX = 0;
  16.          item.offsetY = 0;
  17.        })
  18.        // 删除对应的数据
  19.        this.gridData.splice(index, 1);
  20.        this.modifier.splice(index, 1);
  21.        this.status = DeletionStatus.FINISH;
  22.      }
  23.    }, () => {
  24.      this.modifier.forEach((item: GridItemModifier, ind: number) => {
  25.        if (ind > index && ind % COLUMN_COUNT !== 0) {
  26.          item.offsetX = -itemAreaWidth;
  27.        } else if (ind > index && ind % COLUMN_COUNT === 0) {
  28.          item.offsetX = itemAreaWidth * 4; // 位置偏移到上一行的最后一列,因此偏移4个gridItem所占的宽度
  29.          item.offsetY = -GRID_ITEM_HEIGHT;
  30.        }
  31.      })
  32.      this.status = DeletionStatus.START;
  33.    })
  34. }
复制代码

  • 交换网格元素,onItemDragStart以及onItemDrop来完成元素的交换功能,supportAnimation设置为true,支持在拖拽时体现动画效果。onItemDragStart函数中 返回目标自界说组件,可以在拖拽过程中体现。onItemDrop函数实验末了网格元素的交换。 源码参考GridExchange.ets。
  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. })
复制代码

  • 编辑模式下,点击有添加标识的网格元素,将其添加到首页应用中,添加过程利用transition来实现动画效果。
  1. GridItem() {
  2.   IconWithNameView({ app: item })
  3. }
  4. // 使用isAddApp控制动画是否显示,只有app添加到首页应用里才显示
  5. .transition(this.isAddApp ? this.effect : null, () => {
  6.   this.isAddApp = false;
  7. })
  8. private effect: TransitionEffect =
  9.   TransitionEffect.OPACITY.animation({
  10.     curve: curves.springMotion(0.6, 0.8)
  11.   })
  12.     // 通过combine方法,这里的动画参数会跟随上面的TransitionEffect,也就是springMotion(0.6, 0.8)
  13.     .combine(TransitionEffect.scale({
  14.       x: 0,
  15.       y: 0
  16.     }))
  17.     // 添加旋转转场效果,这里的动画参数会跟随上面带animation的TransitionEffect,也就是springMotion(0.6, 0.8)
  18.     .combine(TransitionEffect.rotate({ angle: 0 }))
  19.       // 添加平移转场效果,这里的动画参数使用指定的springMotion()
  20.     .combine(TransitionEffect.translate({ x: 150 })
  21.       .animation({ curve: curves.springMotion() }))
  22.       // 添加move转场效果,这里的动画参数会跟随上面的TransitionEffect,也就是springMotion()
  23.     .combine(TransitionEffect.move(TransitionEdge.END))
复制代码
性能知识点



  • 动态加载数据场景可以利用LazyForEach遍历数据。
  • onAreaChange 在地区发生巨细变革的时间会举行调用,由于删除操纵大概网格元素的交互都可以大概触发地区函数的利用,操纵频仍, 发起此处淘汰日志日志的打印、复用函数逻辑来低沉性能的内耗。
  • onTouch 在举行手势操纵的时间会举行多次调用,发起此处淘汰日志日志的打印、复用函数逻辑来低沉性能的内耗。
工程结构&模块范例

  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企服之家,中国第一个企服评测及商务社交产业平台。

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有账号?立即注册

×
回复

使用道具 举报

登录后关闭弹窗

登录参与点评抽奖  加入IT实名职场社区
去登录
快速回复 返回顶部 返回列表