From d85211c1392519c3d71cd5728b916082899cea74 Mon Sep 17 00:00:00 2001 From: b30058220 Date: Fri, 30 May 2025 15:44:31 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E6=8B=96=E6=8B=BD=E6=96=87?= =?UTF-8?q?=E6=A1=A3=E9=97=AE=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: b30058220 Change-Id: I785a289d13390d343dd8af7c214b8a4381fbad4a --- .../arkui-ts/ts-universal-events-drag-drop.md | 38 ++++++++++++++++--- .../js-apis-arkui-dragController.md | 6 +++ 2 files changed, 38 insertions(+), 6 deletions(-) diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-events-drag-drop.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-events-drag-drop.md index bd752aae0f5..6b1bec75259 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-events-drag-drop.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-events-drag-drop.md @@ -128,8 +128,8 @@ onDrop(eventCallback: OnDragEventCallback, dropOptions?: DropOptions) | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------------------------------- | ---- | ------------------------------ | -| eventCallback | (event: DragEvent, extraParams?: string) => void | 是 | 回调函数。
**说明：**
event为拖拽事件信息，包括拖拽点坐标。
extraParams为拖拽事件额外信息，需要解析为Json格式，参考[extraParams](#extraparams说明)说明。| -| dropOptions | bool | 否 | 设置拖拽是否提前获取数据。
**说明：**
当使用startDataLoading获取数据时需设置该参数为true，防止拖拽提前获取数据。 | +| eventCallback | [OnDragEventCallback](#ondrageventcallback15) | 是 | 回调函数。
**说明：**
event为拖拽事件信息，包括拖拽点坐标。
extraParams为拖拽事件额外信息，需要解析为Json格式，参考[extraParams](#extraparams说明)说明。| +| dropOptions | [DropOptions](#dropoptions15) | 否 | 落入过程的参数 | ## onDragEnd10+ @@ -149,7 +149,7 @@ onDragEnd(event: (event: DragEvent, extraParams?: string) => void) ## onPreDrag12+ -onPreDrag(event: (preDragStatus: PreDragStatus) => void) +onPreDrag(callback: Callback) 绑定此事件的组件，当处于拖拽发起前的不同阶段时，触发回调。 @@ -161,7 +161,7 @@ onPreDrag(event: (preDragStatus: PreDragStatus) => void) | 参数名 | 类型 | 必填 | 说明 | | ----------- | ------------------------------- | ---- | ------------------------------ | -| callback | Callback<(preDragStatus: [PreDragStatus](#predragstatus12枚举说明)> ) => void | 是 | 回调函数。| +| callback | Callback<[PreDragStatus](#predragstatus12枚举说明)> | 是 | 回调函数。| ## DragItemInfo说明 @@ -322,6 +322,32 @@ type DataSyncOptions = GetDataParams | ----- | ----------------- | | [GetDataParams](../../apis-arkdata/js-apis-data-unifiedDataChannel.md#getdataparams15) | 表示从UDMF获取数据时的参数，包含目标路径、文件冲突选项、进度条类型等。| +## OnDragEventCallback15+ + +type OnDragEventCallback = (event: DragEvent, extraParams?: string) => void + +作为onDrop的入参对象。 + +**原子化服务API：** 从API version 15开始，该接口支持在原子化服务中使用。 + +**系统能力：** SystemCapability.ArkUI.ArkUI.Full + +| 类型 | 说明 | +| ----- | ----------------- | +| (event: DragEvent, extraParams?: string) => void | 拖拽事件的回调函数。| + +## DropOptions15+ + +设置落入过程的参数。 + +**原子化服务API：** 从API version 15开始，该接口支持在原子化服务中使用。 + +**系统能力：** SystemCapability.ArkUI.ArkUI.Full + +| 参数名 | 类型 | 描述 | +| ------ | ------ | ---------------- | +| disableDataPrefetch | bool | 设置拖拽是否提前获取数据。
**说明：**
当使用startDataLoading获取数据时需设置该参数为true，防止拖拽提前获取数据。 | + ## 示例 ### 示例1（设置组件拖拽和落入） @@ -817,9 +843,9 @@ struct Index { .onDragEnd((event) => { if (event.getResult() === DragResult.DRAG_SUCCESSFUL) { - promptAction.showToast({ duration: 100, message: 'Drag Success' }); + this.getUIContext().getPromptAction().showToast({ duration: 100, message: 'Drag Success' }); } else if (event.getResult() === DragResult.DRAG_FAILED) { - promptAction.showToast({ duration: 100, message: 'Drag failed' }); + this.getUIContext().getPromptAction().showToast({ duration: 100, message: 'Drag failed' }); } }) diff --git a/zh-cn/application-dev/reference/apis-arkui/js-apis-arkui-dragController.md b/zh-cn/application-dev/reference/apis-arkui/js-apis-arkui-dragController.md index db3b8fe11ef..a670a1de02b 100644 --- a/zh-cn/application-dev/reference/apis-arkui/js-apis-arkui-dragController.md +++ b/zh-cn/application-dev/reference/apis-arkui/js-apis-arkui-dragController.md @@ -439,6 +439,12 @@ startDrag(): Promise<void> **系统能力：** SystemCapability.ArkUI.ArkUI.Full +**返回值：** + +| 类型 | 说明 | +| -------- | -------- | +| Promise<void> | Promise对象。无返回结果的Promise对象。 | + **错误码：** | 错误码ID | 错误信息 | -- Gitee