鸿蒙开发:实现一个超简单的网格拖拽

简介: 实现拖拽,最重要的三个方法就是,打开编辑状态editMode,实现onItemDragStart和onItemDrop,设置拖拽移动动画和交换数据,如果想到开启补位动画,还需要实现supportAnimation方法。

前言


网格拖拽,此功能很是常见,一般用于频道的编辑或者条目顺序的排列,在鸿蒙的开发中,针对网格的编辑,系统也给出了相关的Api,通过onItemDragStart和在onItemDrop即可轻松实现,onItemDragStart用于设置拖拽过程中的显示,onItemDrop是进行数据交换逻辑处理。


根据官方提供,我们随便实现了一个简单的拖拽效果:


@Entry
  @Component
  struct Index {
    @State numbers: number[] = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
    @Builder
    itemLayout(text: string) {
      Text(text)
        .fontSize(16)
        .backgroundColor(Color.Pink)
        .width(80)
        .height(80)
        .textAlign(TextAlign.Center)
    }
    changeIndex(index1: number, index2: number) { //交换数组位置
      let temp = this.numbers[index1];
      this.numbers[index1] = this.numbers[index2];
      this.numbers[index2] = temp;
    }
    build() {
      Column() {
        Grid() {
          ForEach(this.numbers, (n: number) => {
            GridItem() {
              this.itemLayout(n.toString())
            }
          })
        }
        .columnsTemplate('1fr 1fr 1fr')
          .columnsGap(10)
          .rowsGap(10)
          .editMode(true) //设置Grid是否进入编辑模式
          .onItemDragStart((event: ItemDragInfo, itemIndex: number) => { //第一次拖拽此事件绑定的组件时,触发回调。
            return this.itemLayout(this.numbers[itemIndex].toString()) //设置拖拽过程中显示
          })
          .onItemDrop((event: ItemDragInfo, itemIndex: number, insertIndex: number,
                       isSuccess: boolean) => {
                         if (!isSuccess || insertIndex >= this.numbers.length) {
                           return
                         }
                         this.changeIndex(itemIndex, insertIndex)
                       })
      }.width('100%')
        .height("100%")
    }
  }



以上代码我们就很简单的实现了一个网格拖拽,实际运行之后,长按确实发生了拖拽,和对应的item也进行了交换,但是并没有一个移动交换的过程,这是因为没有设置拖拽动画方法,如果想要拖拽过程中有移动动画,只需要设置supportAnimation为true即可,除此之外,还有一个非常重要的属性,那就是editMode,为true即为编辑模式,false即不可编辑。


拖拽的代码很是简单,毕竟官方也给出了相关案例,其中有两个点是未给出的,那就是禁止拖拽,和禁止与其交换。


比如,第一个和第二个条目,不能拖拽,如何进行设置呢?再比如,任何条目都不能和第一个进行交换,又该如何设置呢?


禁止拖拽


还是上述的代码,例如,把第一个条目禁止,不让其执行拖拽,实现起来很是简单,在onItemDragStart方法里,如果触摸的是指定索引,不让其执行即可。


.onItemDragStart((event: ItemDragInfo, itemIndex: number) => { 
  //第一次拖拽此事件绑定的组件时,触发回调。
  if (itemIndex == 0) {
    //禁止拖拽
    return
  }
  return this.itemLayout(this.numbers[itemIndex].toString()) //设置拖拽过程中显示
})


需要注意的是,以上的代码仅仅是做到了禁止拖拽,但是,有一个潜在的问题是,别的条目是可以和它进行交换的,交换过之后,由于它的索引发生了变化,就变得可以拖拽了,如果想实现真正的,即便被交换后也不能拖拽,那就不能判断索引了,可以以唯一值进行判断,比如item数据换成对象,在对象里定义唯一值。


禁止交换


实际的开发中,除了某个条目禁止拖拽之外,也有不能和它进行交换的逻辑,比如第一个条目,就是固定的,不仅仅禁止拖拽,也不能和其进行交换,这种情况下如何进行实现呢?


onItemDrop((event: ItemDragInfo, itemIndex: number, insertIndex: number,
            isSuccess: boolean) => {
              //第一个禁止交换
              if (insertIndex <= 0) {
                return
              }
              if (!isSuccess || insertIndex >= this.numbers.length) {
                return
              }
              this.changeIndex(itemIndex, insertIndex)
            })


很是简单,如果是第一个,直接不执行即可,以上的代码虽然实现了禁止交换,但是有一个问题,那就是实际的动画已经执行了,只是最后的交换没有执行而已,在视觉上仍然存在很大的问题。



我们想要的效果是,保留移动拖拽的动画,只是拖拽到第一个时,动画不执行,其他的该怎么执行就怎么执行。


那么,在设置supportAnimation动画的时候,就不能直接设置为true了,而是移动到条目一的位置后,设置为fasle,其他再设置为true。


如何拿到第一个item的坐标呢,其实每一个组件都有一个方法,onAreaChange,通过这个属性,我们就可以拿到任何一个组件的宽高还有,xy的坐标,当然,你也可以通过计算的方式,毕竟,屏幕的宽高,还有条目的宽高你都知道。


手势移动的坐标可以通过onTouch方法进行获取,在Move事件中进行判断,如果移动到了条目一的范围之内,取消动画,否则就执行动画。



简单实现


目前呢这个网格拖拽功能已经做了一层封装,放到了refresh库中,大家如果想直接使用,可以依赖这个库:


"dependencies": { "@abner/refresh": "^1.3.6"}


简单案例如下:


import { GridDropView } from '@abner/refresh'
@Entry
  @Component
  struct Index {
    @State numbers: number[] = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
    @Builder
    itemLayout(item: Object, _: number) {
      Text(item.toString())
        .fontSize(16)
        .backgroundColor(Color.Pink)
        .width(80)
        .height(80)
        .textAlign(TextAlign.Center)
    }
    build() {
      Column() {
        GridDropView({
          columnsTemplate:"1fr 1fr 1fr",
          items: this.numbers,
          itemLayout: this.itemLayout,
          dropLayout: this.itemLayout,
          rowsGap: 10,
          columnsGap: 10,
          isEditMode: true,
          prohibitDrop: [0, 1], //禁止拖拽的索引
          prohibitMaxSwap: 0, //禁止交换
          onDropData: (items) => {
            console.log("拖拽结束:" + JSON.stringify(items))
          }
        })
      }.width('100%')
        .height("100%")
    }
  }


注意事项


实现拖拽,最重要的三个方法就是,打开编辑状态editMode,实现onItemDragStart和onItemDrop,设置拖拽移动动画和交换数据,如果想到开启补位动画,还需要实现supportAnimation方法。

相关文章
|
1天前
|
存储 人工智能 JavaScript
Harmony OS开发-ArkTS语言速成二
本文介绍了ArkTS基础语法,包括三种基本数据类型(string、number、boolean)和变量的使用。重点讲解了let、const和var的区别,涵盖作用域、变量提升、重新赋值及初始化等方面。期待与你共同进步!
60 47
Harmony OS开发-ArkTS语言速成二
|
2天前
|
索引
鸿蒙开发:自定义一个股票代码选择键盘
金融类的软件,特别是股票基金类的应用,在查找股票的时候,都会有一个区别于正常键盘的键盘,也就是股票代码键盘,和普通键盘的区别就是,除了常见的数字之外,也有一些常见的股票代码前缀按钮,方便在查找股票的时候,更加方便的进行检索。
鸿蒙开发:自定义一个股票代码选择键盘
|
2天前
鸿蒙开发:自定义一个英文键盘
实现方式呢,有很多种,目前采用了比较简单的一种,如果大家采用网格Grid组件实现方式,也是可以的,但是需要考虑每行的边距以及数据,还有最后两行的格子占位问题。
鸿蒙开发:自定义一个英文键盘
|
3天前
|
存储 JSON 数据库
鸿蒙元服务项目实战:备忘录内容编辑开发
富文本内容编辑我们直接使用RichEditor组件即可,最重要的就是参数,value: RichEditorOptions,通过它,我们可以用来设置样式,和获取最后的富文本内容,这一点是很重要的。
鸿蒙元服务项目实战:备忘录内容编辑开发
|
3天前
|
开发框架 JavaScript 前端开发
Harmony OS开发-ArkT语言速成一
本文介绍ArkTS语言,它是鸿蒙生态的应用开发语言,基于TypeScript,具有静态类型检查、声明式UI、组件化架构、响应式编程等特性,支持跨平台开发和高效性能优化。ArkTS通过强化静态检查和分析,提升代码健壮性和运行性能,适用于Web、移动端和桌面端应用开发。关注我,带你轻松掌握HarmonyOS开发。
25 5
Harmony OS开发-ArkT语言速成一
|
2天前
|
前端开发 API 数据库
鸿蒙开发:异步并发操作
在结合async/await进行使用的时候,有一点需要注意,await关键字必须结合async,这两个是搭配使用的,缺一不可,同步风格在使用的时候,如何获取到错误呢,毕竟没有catch方法,其实,我们可以自己创建try/catch来捕获异常。
鸿蒙开发:异步并发操作
|
3天前
鸿蒙开发:简单了解属性动画
无论是是使用animateTo还是animation,其实最终要改变的都是组件的可执行属性,最终的效果是一致的,animateTo是闭包内改变属性引起的界面变化,一般作用于出现消失转场,而animation则是组件通过属性接口绑定的属性变化引起的界面变化,一般使用场景为,animateTo适用对多个可动画属性配置相同动画参数的动画,需要嵌套使用动画的场景;animation适用于对多个可动画属性配置不同参数动画的场景。
|
2天前
|
API
鸿蒙开发:实现popup弹窗
目前提供了两种方式实现popup弹窗,主推系统实现的方式,几乎能满足我们常见的所有场景,当然了,文章毕竟有限,尽量还是以官网为主。
鸿蒙开发:实现popup弹窗
|
3天前
鸿蒙开发:了解显式动画animateTo
在实际的开发中,应该遵循规范,正确的使用属性动画animateTo,切莫在轮询中使用,否则就会造成本不属当前的动画进行执行,造成UI错误,还有一点需要注意,那就是直接使用animateTo可能导致实例不明确的问题,建议使用getUIContext获取UIContext实例,并使用animateTo调用绑定实例的animateTo。
鸿蒙开发:了解显式动画animateTo
|
3天前
|
API
鸿蒙开发:了解帧动画
在设置图片帧信息集合的时候,是不支持动态更新的,这一点大家需要知道,还有最重要的一点就是,在性能上是不如属性动画的,也就是说能用属性动画实现的,尽量使用属性动画。

热门文章

最新文章