From f3252a8a8409ad415a050ff1b23c8261e3ee9330 Mon Sep 17 00:00:00 2001 From: yaoyuchi Date: Fri, 22 Apr 2022 11:43:03 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E6=A3=80=E8=A7=86=E6=84=8F?= =?UTF-8?q?=E8=A7=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: yaoyuchi --- .../arkui-js/js-components-common-events.md | 204 +++++++++--------- 1 file changed, 102 insertions(+), 102 deletions(-) diff --git a/zh-cn/application-dev/reference/arkui-js/js-components-common-events.md b/zh-cn/application-dev/reference/arkui-js/js-components-common-events.md index 5bda3a4072..b0ef135057 100644 --- a/zh-cn/application-dev/reference/arkui-js/js-components-common-events.md +++ b/zh-cn/application-dev/reference/arkui-js/js-components-common-events.md @@ -91,7 +91,7 @@ | timestamp | number | 时间戳。 | | dataTransfer | DataTransfer | DataTransfer对象9+。 | -## **target对象** +## target对象 当组件触发事件后，事件回调函数默认会收到一个事件对象，通过该事件对象可以获取相应的信息。 @@ -131,24 +131,24 @@ clearData(key?: string): boolean 删除与给定类型关联的数据。如果类型为空或未指定，则删除所有数据。如果指定类型的数据不存在，或者data transfer中不包含任何数据，则该方法不会产生任何效果。 -**参数：** +- 参数： -| 参数名 | 参数类型 | 必填 | 描述 | -| ------ | -------- | ---- | ------------------------------------------ | -| key | string | 否 | 数据类型。key值存在时删除该类型关联的数据，key为空时删除所有数据。 | + | 参数名 | 参数类型 | 必填 | 描述 | + | ------ | -------- | ---- | ------------------------------------------ | + | key | string | 否 | 数据类型。key值存在时删除该类型关联的数据，key为空时删除所有数据。 | -**返回值：** -| 类型 | 说明 | -| ------ | -------- | -| bool | 执行结果 | +- 返回值： + | 类型 | 说明 | + | ------ | -------- | + | bool | 执行结果 | -**示例：** +- 示例： - ```js - dragEnd(e){ - var isSuccess = e.dataTransfer.clearData('name'); - } - ``` + ```js + dragEnd(e){ + var isSuccess = e.dataTransfer.clearData('name'); + } + ``` ### getData @@ -156,30 +156,30 @@ clearData(key?: string): boolean 获取给定类型关联的数据，如果该类型的数据不存在或data transfer不包含数据，则返回空字符串。 -**参数：** +- 参数： -| 参数名 | 参数类型 | 必填 | 描述 | -| ------ | -------- | ---- | -------------------------- | -| key | string | 是 | 数据类型 | + | 参数名 | 参数类型 | 必填 | 描述 | + | ------ | -------- | ---- | -------------------------- | + | key | string | 是 | 数据类型 | -**返回值：** -| 类型 | 说明 | -| ------ | -------- | -| object | 获取的数据 | +- 返回值： + | 类型 | 说明 | + | ------ | -------- | + | object | 获取的数据 | -**示例：** +- 示例： - ```js - dragStart(e){ - var person = new Object(); - person.name = "list"; - person.age = 21; - e.dataTransfer.setData('person', person); - }, - dragEnd(e){ - var result = e.dataTransfer.getData('person'); - }, - ``` + ```js + dragStart(e){ + var person = new Object(); + person.name = "list"; + person.age = 21; + e.dataTransfer.setData('person', person); + }, + dragEnd(e){ + var result = e.dataTransfer.getData('person'); + }, + ``` ### setData @@ -187,33 +187,33 @@ setData(key: string, value: object): boolean 设置给定类型关联的数据。如果该类型的数据不存在，则将其添加到末尾。如果该类型的数据已经存在，则在相同位置替换现有数据。 -**参数：** - -| 参数名 | 参数类型 | 必填 | 描述 | -| ------ | -------- | ---- | ----------------------- | -| key | string | 是 | 数据类型 | -| value | object | 是 | 要存储的数据 | - -**返回值：** -| 类型 | 说明 | -| ------ | -------- | -| bool | 执行结果 | - -**示例：** - - ``` - //setData 可以是基本数据类型，也可以是对象类型 - dragStart(e){ - var isSetOk = e.dataTransfer.setData('name', 1); - } - 或 - dragStart(e){ - var person = new Object(); - person.name = "list"; - person.age = 21; - var isSetOk = e.dataTransfer.setData('person', person); - } - ``` +- 参数： + + | 参数名 | 参数类型 | 必填 | 描述 | + | ------ | -------- | ---- | ----------------------- | + | key | string | 是 | 数据类型 | + | value | object | 是 | 要存储的数据 | + +- 返回值： + | 类型 | 说明 | + | ------ | -------- | + | bool | 执行结果 | + +- 示例： + + ``` + //setData 可以是基本数据类型，也可以是对象类型 + dragStart(e){ + var isSetOk = e.dataTransfer.setData('name', 1); + } + 或 + dragStart(e){ + var person = new Object(); + person.name = "list"; + person.age = 21; + var isSetOk = e.dataTransfer.setData('person', person); + } + ``` ### setDragImage @@ -221,43 +221,43 @@ setDragImage(pixelmap: Pixelmap, offsetX: number,offsetY: number): boolean 用于设置自定义的拖动图像。 -**参数：** - -| pixelmap | 参数类型 | 必填 | 描述 | -| -------- | -------- | ---- | ------------------------------------------------------------ | -| pixelmap | PixelMap | 是 | pixelmap为前端传入的图片资源，请参考[PixelMap对象](../apis/js-apis-image.md)。 | -| offsetX | number | 是 | 相对于图片的横向偏移量 | -| offsetY | number | 是 | 相对于图片的纵向偏移量 | - -**返回值：** -| 类型 | 说明 | -| ------ | -------- | -| bool | 执行结果 | - -**示例：** - - ```js - CreatePixelMap(){ - let color=new ArrayBuffer(4*96*96); - var buffer=new Uint8Array(color); - for(var i=0;i{ - console.error('-----create pixmap has info message:'+JSON.stringify(data)); - this.pixelMap=data; - this.pixelMapReader=data; - }) - }, - dragStart(e){ - e.dataTransfer.setDragImage(this.pixelMapReader, 50, 50); - }, - ``` +- 参数： + + | pixelmap | 参数类型 | 必填 | 描述 | + | -------- | -------- | ---- | ------------------------------------------------------------ | + | pixelmap | PixelMap | 是 | pixelmap为前端传入的图片资源，请参考[PixelMap对象](../apis/js-apis-image.md)。 | + | offsetX | number | 是 | 相对于图片的横向偏移量 | + | offsetY | number | 是 | 相对于图片的纵向偏移量 | + +- 返回值： + | 类型 | 说明 | + | ------ | -------- | + | bool | 执行结果 | + +- 示例： + + ```js + CreatePixelMap(){ + let color=new ArrayBuffer(4*96*96); + var buffer=new Uint8Array(color); + for(var i=0;i{ + console.error('-----create pixmap has info message:'+JSON.stringify(data)); + this.pixelMap=data; + this.pixelMapReader=data; + }) + }, + dragStart(e){ + e.dataTransfer.setDragImage(this.pixelMapReader, 50, 50); + }, + ``` -- GitLab