文档开发者中心
我的
|

HarmonyOS 5

grid组件如何用onmove使用拖动排序

已解决

grid组件如何用onmove使用拖动排序

点赞
收藏
2
回复
9
分享
举报
浏览142 发布于2026-07-11 19:17海南
全部评论
最多点赞
最新发布
最早发布
|
采纳答复
8楼回复于2026-07-13 17:37 来自北京

您好,可以参考下官方实践案例:动态发布时九宫格图片拖拽排序

  • 示例基于Grid网格容器实现九宫格图片拖拽排序功能,可拖拽图片与其他任意图片交换位置。

5楼回复于2026-07-13 01:54 来自广东

楼主你好。

onMove 本身不会自动帮你完成拖动排序,它只是把拖动前后的索引告诉你,真正的数据交换需要自己实现。

很多人第一次用的时候都会以为:

开启 editMode(true) + onMove(),Grid 就会自动调整顺序。

实际上不是这样的。

正确的实现流程

整个流程一般是:

开启编辑模式 → 长按开始拖动 → 触发 onMove(from, to) → 调整数据源顺序 → Grid 根据数据重新刷新

也就是说,真正决定 Grid 显示顺序的是你的数据源,而不是 onMove()。

例如:

收起
自动换行
深色代码主题
复制
Grid() {
  ForEach(this.list, (item) => {
    GridItem() {
      ...
    }
  })
}
.editMode(true)
.onMove((from, to) => {
  this.moveItem(from, to)
})

然后在 moveItem() 中调整数组:

收起
自动换行
深色代码主题
复制
moveItem(from: number, to: number) {
  const item = this.list.splice(from, 1)[0]
  this.list.splice(to, 0, item)
}

只要数据源发生变化,Grid 就会按照新的顺序重新布局。

为什么有时候拖了又弹回去?

这种情况基本都是因为:

onMove() 收到了新的位置,但是数据源没有修改。

例如:

收起
自动换行
深色代码主题
复制
A B C D

拖到:

B A C D

如果数组还是:

收起
自动换行
深色代码主题
复制
[A, B, C, D]

下一帧 Grid 又会重新按照数据源布局,所以看起来就是"拖过去又回来了"。

还有几个容易踩的坑

1、不要修改 ForEach 的 key

很多人写:

收起
自动换行
深色代码主题
复制
ForEach(this.list, item => {}, item => item.id)

这里的 id 最好保持唯一且固定。

不要因为排序就去修改 id,否则 Grid 会认为这是新的元素,容易出现闪烁或重建。

2、不要重新 new 整个数组

例如:

收起
自动换行
深色代码主题
复制
this.list = newList

虽然可以刷新,但如果数据量比较大,性能不如直接:

收起
自动换行
深色代码主题
复制
splice()

直接修改原数组。

3、开启编辑模式

如果没有:

收起
自动换行
深色代码主题
复制
.editMode(true)

默认是不能拖动排序的。

如果是动态控制,可以绑定状态:

收起
自动换行
深色代码主题
复制
.editMode(this.isEdit)

进入编辑模式后再允许拖动。

我的建议

如果只是做类似桌面图标、应用列表那种拖动排序,推荐直接使用 editMode(true) + onMove(),然后在 onMove() 中同步修改数据源即可。

整个流程建议理解成:

长按 GridItem → 开始拖动 → onMove(from, to) → 调整数组顺序 → Grid 自动刷新

展开全部
7楼回复于2026-07-13 11:30 来自辽宁

Grid组件使用onMove实现拖拽排序有两种路径,取决于你使用的API版本。从API版本26.0.0开始,Grid原生支持onMove拖拽排序,但仅在可滚动场景下生效。在此之前,onMove仅在父组件为List时有效果,Grid组件需要通过editMode+onItemDragStart+onItemDrop组合实现拖拽排序

6楼回复于2026-07-13 07:26 来自湖北

补一个可直接改造的 Grid 排序 demo。Grid 自己有拖拽回调,核心是:开启 `editMode(true)`,在 `onItemDrop` 里根据 `itemIndex` 和 `insertIndex` 调整数据源。

```ts

@Entry

@Component

struct GridDragDemo {

  @State items: string[] = ['A', 'B', 'C', 'D', 'E', 'F'];

  @State dragText: string = '';

  @Builder

  dragPreview() {

    Text(this.dragText)

      .width(72)

      .height(72)

      .textAlign(TextAlign.Center)

      .backgroundColor('#E8F0FE')

      .borderRadius(12)

  }

  private moveItem(from: number, to: number): void {

    if (from === to || from < 0 || to < 0 ||

      from >= this.items.length || to >= this.items.length) {

      return;

    }

    const next = this.items.slice();

    const moved = next.splice(from, 1)[0];

    next.splice(to, 0, moved);

    this.items = next;

  }

  build() {

    Grid() {

      ForEach(this.items, (item: string) => {

        GridItem() {

          Text(item)

            .width('100%')

            .height(72)

            .textAlign(TextAlign.Center)

            .backgroundColor('#F2F3F5')

            .borderRadius(12)

        }

      }, (item: string) => item)

    }

    .columnsTemplate('1fr 1fr 1fr')

    .rowsGap(12)

    .columnsGap(12)

    .padding(16)

    .editMode(true)

    .supportAnimation(true)

    .onItemDragStart((_event: ItemDragInfo, itemIndex: number) => {

      this.dragText = this.items[itemIndex];

      return this.dragPreview();

    })

    .onItemDrop((_event: ItemDragInfo, itemIndex: number, insertIndex: number, isSuccess: boolean) => {

      if (isSuccess) {

        this.moveItem(itemIndex, insertIndex);

      }

    })

  }

}

```

注意两点:

1. ForEach 的 key 不要用 index,用业务 id 或 item 本身,否则排序后复用可能错乱;

2. 如果需要拖到边缘自动滚动,要再配合 `onItemDragMove` 和滚动定位处理,单靠拖拽回调不一定自动滚屏。

官方参考:

https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-grid

https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-grid-drag-swap

展开全部
4楼回复于2026-07-12 11:27 来自湖北
支持拖拽的
3楼回复于2026-07-12 07:59 来自河南
`Grid` 组件支持 `onMove` 拖拽排序是从 **API version 26.0.0** 开始支持的。
1
2楼回复于2026-07-12 00:37 来自广东
  • 无语的我回来了
    有现成的demo吗
    2026-07-12 07:37 来自海南

Grid 不能直接使用 ForEach/LazyForEach 的 onMove 做排序。onMove 目前仅适用于 List 中每次迭代生成 ListItem 的场景;Grid 应使用自身的拖拽回调。

处理步骤:

1. editMode(true) 开启 GridItem 拖拽;

2. supportAnimation(true) 开启内置拖拽动画;

3. onItemDragStart 返回拖拽预览;

4. onItemDrop 根据 itemIndex 和 insertIndex 更新数据源。

```

@Entry

@Component

struct GridDragPage {

  @State private items: string[] = ['A', 'B', 'C', 'D', 'E', 'F']

  @State private dragText: string = ''

  @Builder

  dragPreview() {

    Text(this.dragText)

      .width(80)

      .height(80)

      .textAlign(TextAlign.Center)

      .backgroundColor('#E8F0FE')

  }

  private moveItem(from: number, to: number): void {

    if (from === to || from < 0 || to < 0 ||

      from >= this.items.length || to >= this.items.length) {

      return

    }

    const next: string[] = [...this.items]

    const moved: string = next.splice(from, 1)[0]

    next.splice(to, 0, moved)

    this.items = next

  }

  build() {

    Grid() {

      ForEach(this.items, (item: string) => {

        GridItem() {

          Text(item)

            .width('100%')

            .height(80)

            .textAlign(TextAlign.Center)

            .backgroundColor('#F2F3F5')

        }

      }, (item: string) => item)

    }

    .columnsTemplate('1fr 1fr 1fr')

    .columnsGap(8)

    .rowsGap(8)

    .editMode(true)

    .supportAnimation(true)

    .onItemDragStart((event: ItemDragInfo, itemIndex: number) => {

      this.dragText = this.items[itemIndex]

      return this.dragPreview()

    })

    .onItemDrop((event: ItemDragInfo, itemIndex: number,

      insertIndex: number, isSuccess: boolean) => {

      if (!isSuccess || insertIndex < 0 || insertIndex >= this.items.length) {

        return

      }

      this.moveItem(itemIndex, insertIndex)

    })

  }

}

```

注意:supportAnimation 的内置动画只支持滚动模式(rowsTemplate、columnsTemplate 只设置一个)且 GridItem 大小规则的 Grid;跨行跨列场景需要自定义动画。若使用 LazyForEach,请在数据源的 move/swap 方法中同步发送数据变更通知。

展开全部
1楼回复于2026-07-11 21:29 未知归属地
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。