目录

长按Image组件拖动,如何避免唤醒小艺

问题现象

拖拽功能支持跨设备、跨应用数据流转,用户可长按图片Image组件直接拖拽至小艺进行AI分析(如文字提取、智能搜索),并支持分屏操作、中转站暂存,提升多设备协同效率与交互便捷性。但在三方应用开发中,当三方应用内部需要自定义Image组件长按操作的业务逻辑(如收藏/点赞)时,如果这时误触发小艺唤醒,导致业务逻辑冲突与交互混乱。如何在实现长按拖动Image组件,同时避免唤醒小艺?

背景知识

解决方案

  1. 将Image组件的draggable设置为false,该属性默认值为true。
  2. 给Image组件配置LongPressGesture长按手势监听,用于标记拖动状态。
  3. 配置onTouch事件,将Image组件的位置实时更新为手指触摸屏幕的位置。

完整示例参考如下:

@Entry
@Component
struct DragDemoForImage {
  @State positionX: number = 100;
  @State positionY: number = 100;
  @State flag: boolean = false;

  build() {
    Stack() {
      Column() {
        Text("This is a text.").fontSize(40).backgroundColor(Color.Green).width('100%').height('10%')
        Stack() {
          // 背景
          Stack() {
            // 若背景为地图,可在这里定义MapComponent组件
          }.width('100%')
          .height('100%');

          // 图片
          Image($r('app.media.startIcon'))
            .position({ x: this.positionX, y: this.positionY })
            .width(50)
            .height(50)
            .draggable(false) // 图片设置为不可拖拽
            // 触发长按拖动
            .gesture(
              // 绑定可以重复触发的LongPressGesture
              LongPressGesture({ duration: 500 })
                .onAction((event: GestureEvent | undefined) => {
                  if (event) {
                    this.flag = true;
                  }
                })
            )
        }.width('100%').height('100%')
        .onTouch((event) => {
          if (this.flag) {
            // 拖动标记位为true时,图片跟随手指移动
            if (event.type === TouchType.Move) {
              // 触摸点默认是图片中心,图标默认大小50*50
              this.positionX = event.touches[0].x - 25;
              this.positionY = event.touches[0].y - 25;
            }
            // 手势抬起时,本次拖动结束
            if (event.type === TouchType.Up) {
              this.flag = false;
            }
          }
        });
      }.width('100%');
    }.height('100%');
  }
}

常见FAQ

Q:拖拽跟拖动有什么区别?

A:在HarmonyOS中,拖拽事件有其明确的定义,即从一个组件位置拖出(drag)数据并将其拖入(drop)到另一个组件位置,以触发响应。实际开发过程中,开发者误认为拖拽就是拖动,将组件draggable设置为true后,使得系统级的组件拖拽能力生效,开发者往往原意想要实现组件在屏幕上随手指移动的能力,而往往这是需要长按手势和触摸事件来实现的。