Merge

Signed-off-by: N王鑫 <xinwangih@isoftstone.com>

zh-cn/application-dev/reference/apis/Readme-CN.md

@@ -370,6 +370,7 @@
   - [@ohos.deviceInfo (设备信息)](js-apis-device-info.md)
   - [@ohos.distributedHardware.deviceManager (设备管理)](js-apis-device-manager.md)
   - [@ohos.geoLocationManager (位置服务)](js-apis-geoLocationManager.md)
+  - [@ohos.multimodalInput.gestureEvent (手势事件)](js-apis-multimodalinput-gestureevent.md)
   - [@ohos.multimodalInput.inputConsumer (组合按键)](js-apis-inputconsumer.md)
   - [@ohos.multimodalInput.inputDevice (输入设备)](js-apis-inputdevice.md)
   - [@ohos.multimodalInput.inputDeviceCooperate (键鼠穿越)(待停用)](js-apis-cooperate.md)

zh-cn/application-dev/reference/apis/js-apis-inputmonitor.md

 # @ohos.multimodalInput.inputMonitor (输入监听)
 
-输入监听模块，提供了监听输入设备事件（当前支持触摸屏和鼠标）的能力。
+输入监听模块，提供了监听输入设备事件（当前支持触屏、鼠标和触控板手势）的能力。
 
 >  **说明：**
 >
@@ -17,11 +17,11 @@ import inputMonitor from '@ohos.multimodalInput.inputMonitor';
 ```
 
 
-## inputMonitor.on
+## inputMonitor.on('touch')
 
-on(type: "touch", receiver: TouchEventReceiver): void
+on(type: 'touch', receiver: TouchEventReceiver): void
 
-开始监听全局触屏事件。
+监听全局触屏事件。
 
 **需要权限：** ohos.permission.INPUT_MONITORING
 
@@ -38,7 +38,7 @@ on(type: "touch", receiver: TouchEventReceiver): void
 
 ```js
 try {
-  inputMonitor.on("touch", (touchEvent) => {
+  inputMonitor.on('touch', (touchEvent) => {
     console.log(`Monitor on success ${JSON.stringify(touchEvent)}`);
     return false;
   });
@@ -47,11 +47,11 @@ try {
 }
 ```
 
-## inputMonitor.on<sup>9+</sup>
+## inputMonitor.on('mouse')<sup>9+</sup>
 
-on(type: "mouse", receiver: Callback&lt;MouseEvent&gt;): void
+on(type: 'mouse', receiver: Callback&lt;MouseEvent&gt;): void
 
-开始监听全局鼠标事件。
+监听全局鼠标事件。
 
 **需要权限：** ohos.permission.INPUT_MONITORING
 
@@ -68,7 +68,7 @@ on(type: "mouse", receiver: Callback&lt;MouseEvent&gt;): void
 
 ```js
 try {
-  inputMonitor.on("mouse", (mouseEvent) => {
+  inputMonitor.on('mouse', (mouseEvent) => {
     console.log(`Monitor on success ${JSON.stringify(mouseEvent)}`);
     return false;
   });
@@ -79,11 +79,11 @@ try {
 
 
 
-## inputMonitor.off
+## inputMonitor.off('touch')
 
-off(type: "touch", receiver?: TouchEventReceiver): void
+off(type: 'touch', receiver?: TouchEventReceiver): void
 
-停止监听全局触屏事件。
+取消监听全局触屏事件。
 
 **需要权限：** ohos.permission.INPUT_MONITORING
 
@@ -105,8 +105,8 @@ function callback(touchEvent) {
   return false;
 };
 try {
-  inputMonitor.on("touch", callback);
-  inputMonitor.off("touch", callback);
+  inputMonitor.on('touch', callback);
+  inputMonitor.off('touch', callback);
   console.log(`Monitor off success`);
 } catch (error) {
   console.log(`Monitor execute failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
@@ -120,19 +120,19 @@ function callback(touchEvent) {
   return false;
 };
 try {
-  inputMonitor.on("touch", callback);
-  inputMonitor.off("touch");
+  inputMonitor.on('touch', callback);
+  inputMonitor.off('touch');
   console.log(`Monitor off success`);
 } catch (error) {
   console.log(`Monitor execute failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
 }
 ```
 
-## inputMonitor.off<sup>9+</sup>
+## inputMonitor.off('mouse')<sup>9+</sup>
 
-off(type: "mouse", receiver?: Callback&lt;MouseEvent&gt;): void
+off(type: 'mouse', receiver?: Callback&lt;MouseEvent&gt;): void
 
-停止监听全局鼠标事件。
+取消监听全局鼠标事件。
 
 **需要权限：** ohos.permission.INPUT_MONITORING
 
@@ -154,8 +154,8 @@ function callback(mouseEvent) {
   return false;
 };
 try {
-  inputMonitor.on("mouse", callback);
-  inputMonitor.off("mouse", callback);
+  inputMonitor.on('mouse', callback);
+  inputMonitor.off('mouse', callback);
   console.log(`Monitor off success`);
 } catch (error) {
   console.log(`Monitor execute failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
@@ -169,8 +169,8 @@ function callback(mouseEvent) {
   return false;
 };
 try {
-  inputMonitor.on("mouse", callback);
-  inputMonitor.off("mouse");
+  inputMonitor.on('mouse', callback);
+  inputMonitor.off('mouse');
   console.log(`Monitor off success`);
 } catch (error) {
   console.log(`Monitor execute failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
@@ -201,7 +201,7 @@ try {
 
 ```js
 try {
-  inputMonitor.on("touch", touchEvent => {
+  inputMonitor.on('touch', touchEvent => {
     if (touchEvent.touches.length == 3) { // 当前有三个手指按下
       return true;
     }
@@ -211,3 +211,240 @@ try {
     console.log(`Monitor on failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
 }
 ```
+
+## inputMonitor.on('pinch')<sup>10+</sup>
+
+on(type: 'pinch', receiver: Callback&lt;[Pinch](js-apis-multimodalinput-gestureevent.md#pinch)&gt;): void
+
+监听全局的触控板捏合事件。
+
+**需要权限：** ohos.permission.INPUT_MONITORING
+
+**系统能力：** SystemCapability.MultimodalInput.Input.InputMonitor
+
+**参数：**
+
+| 参数名       | 类型                         | 必填   | 说明                  |
+| -------- | -------------------------- | ---- | ------------------- |
+| type     | string                     | 是    | 输入设备事件类型，取值“pinch”。 |
+| receiver | Callback&lt;[Pinch](js-apis-multimodalinput-gestureevent.md#pinch)&gt; | 是    | 回调函数，异步上报捏合输入事件。  |
+
+  **示例：**
+
+```js
+try {
+  inputMonitor.on('pinch', (pinchEvent) => {
+    console.log(`Monitor on success ${JSON.stringify(pinchEvent)}`);
+    return false;
+  });
+} catch (error) {
+  console.log(`Monitor on failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
+}
+```
+
+## inputMonitor.off('pinch')<sup>10+</sup>
+
+off(type: 'pinch', receiver?: Callback&lt;[Pinch](js-apis-multimodalinput-gestureevent.md#pinch)&gt;): void
+
+取消监听全局的触控板捏合事件。
+
+**需要权限：** ohos.permission.INPUT_MONITORING
+
+**系统能力：** SystemCapability.MultimodalInput.Input.InputMonitor
+
+**参数：**
+
+| 参数名       | 类型                         | 必填   | 说明                  |
+| -------- | -------------------------- | ---- | ------------------- |
+| type     | string                     | 是    | 输入设备事件类型，取值“pinch”。 |
+| receiver | Callback&lt;[Pinch](js-apis-multimodalinput-gestureevent.md#pinch)&gt; | 否    | 需要取消监听的回调函数，若无此参数，则取消当前应用监听的所有回调函数。 |
+
+**示例：**
+
+```js
+// 取消监听单个回调函数
+function callback(pinchEvent) {
+  console.log(`Monitor on success ${JSON.stringify(pinchEvent)}`);
+  return false;
+};
+try {
+  inputMonitor.on('pinch', callback);
+  inputMonitor.off('pinch', callback);
+  console.log(`Monitor off success`);
+} catch (error) {
+  console.log(`Monitor execute failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
+}
+```
+
+```js
+// 取消监听所有回调函数
+function callback(pinchEvent) {
+  console.log(`Monitor on success ${JSON.stringify(pinchEvent)}`);
+  return false;
+};
+try {
+  inputMonitor.on('pinch', callback);
+  inputMonitor.off('pinch');
+  console.log(`Monitor off success`);
+} catch (error) {
+  console.log(`Monitor execute failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
+}
+```
+
+## inputMonitor.on('threeFingersSwipe')<sup>10+</sup>
+
+on(type: 'threeFingersSwipe', receiver: Callback&lt;[ThreeFingersSwipe](js-apis-multimodalinput-gestureevent.md#threefingersswipe)&gt;): void
+
+监听全局的触控板三指滑动事件。
+
+**需要权限：** ohos.permission.INPUT_MONITORING
+
+**系统能力：** SystemCapability.MultimodalInput.Input.InputMonitor
+
+**参数：**
+
+| 参数名       | 类型                         | 必填   | 说明                  |
+| -------- | -------------------------- | ---- | ------------------- |
+| type     | string                     | 是    | 输入设备事件类型，取值“threeFingersSwipe”。 |
+| receiver | Callback&lt;[ThreeFingersSwipe](js-apis-multimodalinput-gestureevent.md#threefingersswipe)&gt; | 是    | 回调函数，异步上报三指滑动输入事件。  |
+
+  **示例：**
+
+```js
+try {
+  inputMonitor.on('threeFingersSwipe', (threeFingersSwipe) => {
+    console.log(`Monitor on success ${JSON.stringify(threeFingersSwipe)}`);
+    return false;
+  });
+} catch (error) {
+  console.log(`Monitor on failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
+}
+```
+
+## inputMonitor.off('threeFingersSwipe')<sup>10+</sup>
+
+off(type: 'threeFingersSwipe', receiver?: Callback&lt;[ThreeFingersSwipe](js-apis-multimodalinput-gestureevent.md#threefingersswipe)&gt;): void
+
+取消监听全局的触控板三指滑动事件。
+
+**需要权限：** ohos.permission.INPUT_MONITORING
+
+**系统能力：** SystemCapability.MultimodalInput.Input.InputMonitor
+
+**参数：**
+
+| 参数名       | 类型                         | 必填   | 说明                  |
+| -------- | -------------------------- | ---- | ------------------- |
+| type     | string                     | 是    | 输入设备事件类型，取值“threeFingersSwipe”。 |
+| receiver | Callback&lt;[ThreeFingersSwipe](js-apis-multimodalinput-gestureevent.md#threefingersswipe)&gt; | 否    | 需要取消监听的回调函数，若无此参数，则取消当前应用监听的所有回调函数。 |
+
+**示例：**
+
+```js
+// 取消监听单个回调函数
+function callback(threeFingersSwipe) {
+  console.log(`Monitor on success ${JSON.stringify(threeFingersSwipe)}`);
+  return false;
+};
+try {
+  inputMonitor.on('threeFingersSwipe', callback);
+  inputMonitor.off("threeFingersSwipe", callback);
+  console.log(`Monitor off success`);
+} catch (error) {
+  console.log(`Monitor execute failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
+}
+```
+
+```js
+// 取消监听所有回调函数
+function callback(threeFingersSwipe) {
+  console.log(`Monitor on success ${JSON.stringify(threeFingersSwipe)}`);
+  return false;
+};
+try {
+  inputMonitor.on("threeFingersSwipe", callback);
+  inputMonitor.off("threeFingersSwipe");
+  console.log(`Monitor off success`);
+} catch (error) {
+  console.log(`Monitor execute failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
+}
+```
+
+## inputMonitor.on('fourFingersSwipe')<sup>10+</sup>
+
+on(type: 'fourFingersSwipe', receiver: Callback&lt;[FourFingersSwipe](js-apis-multimodalinput-gestureevent.md#fourfingersswipe)&gt;): void
+
+监听全局的触控板四指滑动事件。
+
+**需要权限：** ohos.permission.INPUT_MONITORING
+
+**系统能力：** SystemCapability.MultimodalInput.Input.InputMonitor
+
+**参数：**
+
+| 参数名       | 类型                         | 必填   | 说明                  |
+| -------- | -------------------------- | ---- | ------------------- |
+| type     | string                     | 是    | 输入设备事件类型，取值“fourFingersSwipe”。 |
+| receiver | Callback&lt;[FourFingersSwipe](js-apis-multimodalinput-gestureevent.md#fourfingersswipe)&gt; | 是    | 回调函数，异步上报四指滑动输入事件。  |
+
+  **示例：**
+
+```js
+try {
+  inputMonitor.on('fourFingersSwipe', (fourFingersSwipe) => {
+    console.log(`Monitor on success ${JSON.stringify(fourFingersSwipe)}`);
+    return false;
+  });
+} catch (error) {
+  console.log(`Monitor on failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
+}
+```
+
+## inputMonitor.off('fourFingersSwipe')<sup>10+</sup>
+
+off(type: 'fourFingersSwipe', receiver?: Callback&lt;[FourFingersSwipe](js-apis-multimodalinput-gestureevent.md#fourfingersswipe)&gt;): void
+
+取消监听全局的触控板四指滑动事件。
+
+**需要权限：** ohos.permission.INPUT_MONITORING
+
+**系统能力：** SystemCapability.MultimodalInput.Input.InputMonitor
+
+**参数：**
+
+| 参数名       | 类型                         | 必填   | 说明                  |
+| -------- | -------------------------- | ---- | ------------------- |
+| type     | string                     | 是    | 输入设备事件类型，取值“fourFingersSwipe”。 |
+| receiver | Callback&lt;[FourFingersSwipe](js-apis-multimodalinput-gestureevent.md#fourfingersswipe)&gt; | 否    | 需要取消监听的回调函数，若无此参数，则取消当前应用监听的所有回调函数。 |
+
+**示例：**
+
+```js
+// 取消监听单个回调函数
+function callback(fourFingersSwipe) {
+  console.log(`Monitor on success ${JSON.stringify(fourFingersSwipe)}`);
+  return false;
+};
+try {
+  inputMonitor.on('fourFingersSwipe', callback);
+  inputMonitor.off('fourFingersSwipe', callback);
+  console.log(`Monitor off success`);
+} catch (error) {
+  console.log(`Monitor execute failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
+}
+```
+
+```js
+// 取消监听所有回调函数
+function callback(fourFingersSwipe) {
+  console.log(`Monitor on success ${JSON.stringify(fourFingersSwipe)}`);
+  return false;
+};
+try {
+  inputMonitor.on('fourFingersSwipe', callback);
+  inputMonitor.off('fourFingersSwipe');
+  console.log(`Monitor off success`);
+} catch (error) {
+  console.log(`Monitor execute failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
+}
+```

zh-cn/application-dev/reference/apis/js-apis-multimodalinput-gestureevent.md

+# @ohos.multimodalInput.gestureEvent (手势输入事件)
+
+设备上报的手势事件。
+
+>  **说明：**
+>
+> 本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+
+## 导入模块
+
+```js
+import { Pinch, ThreeFingersSwipe, FourFingersSwipe, ActionType } from '@ohos.multimodalInput.gestureEvent';
+```
+
+## Pinch
+
+捏合事件。
+
+**系统能力**：SystemCapability.MultimodalInput.Input.Core
+
+| 名称             | 类型        | 可读   | 可写   | 说明                                       |
+| -------------- | ----------- | ---- | ---- | ---------------------------------------- |
+| type         | [ActionType](#actiontype)   | 是    | 否    | 捏合事件类型                                   |
+| scale        | number      | 是    | 否    | 捏合度，取值范围大于等于0                             |
+
+## ThreeFingersSwipe
+
+三指滑动事件。
+
+**系统能力**：SystemCapability.MultimodalInput.Input.Core
+
+| 名称             | 类型        | 可读   | 可写   | 说明                                       |
+| -------------- | ----------- | ---- | ---- | ---------------------------------------- |
+| type         | [ActionType](#actiontype)   | 是    | 否    | 三指滑动事件类型                                   |
+| x        | number      | 是    | 否    | 坐标x                             |
+| y        | number      | 是    | 否    | 坐标y                             |
+
+## FourFingersSwipe
+
+四指滑动事件。
+
+**系统能力**：SystemCapability.MultimodalInput.Input.Core
+
+| 名称             | 类型        | 可读   | 可写   | 说明                                       |
+| -------------- | ----------- | ---- | ---- | ---------------------------------------- |
+| type         | [ActionType](#actiontype)   | 是    | 否    | 四指滑动事件类型                                   |
+| x        | number      | 是    | 否    | 坐标x                             |
+| y        | number      | 是    | 否    | 坐标y                             |
+
+
+## ActionType
+
+手势事件类型。
+
+**系统能力**：SystemCapability.MultimodalInput.Input.Core
+
+| 名称        | 值  | 说明             |
+| ----------- | --- | --------------- |
+| CANCEL      | 0   | 取消             |
+| BEGIN       | 1   | 手势开始         |
+| UPDATE      | 2   | 手势更新         |
+| END         | 3   | 手势结束         |

zh-cn/application-dev/reference/arkui-ts/ts-basic-components-image.md

@@ -50,6 +50,7 @@ Image(src: PixelMap | ResourceStr | DrawableDescriptor)
 | syncLoad<sup>8+</sup>    | boolean                                  | 设置是否同步加载图片，默认是异步加载。同步加载时阻塞UI线程，不会显示占位图。<br/>默认值：false<br/>从API version 9开始，该接口支持在ArkTS卡片中使用。 |
 | copyOption<sup>9+</sup>  | [CopyOptions](ts-appendix-enums.md#copyoptions9) | 设置图片是否可复制（SVG图片不支持复制）。<br/>当copyOption设置为非CopyOptions.None时，支持使用长按、鼠标右击、快捷组合键'CTRL+C'等方式进行复制。<br/>默认值：CopyOptions.None<br/>该接口支持在ArkTS卡片中使用。 |
 | colorFilter<sup>9+</sup> | [ColorFilter](ts-types.md#colorfilter9)  | 给图像设置颜色滤镜效果。<br/>该接口支持在ArkTS卡片中使用。       |
+| draggable<sup>(deprecated)</sup>   | boolean                                  | 设置默认拖拽效果。（不能和[onDragStart](ts-universal-events-drag-drop.md)事件同时使用。）<br/>默认值：false<br/>该接口支持在ArkTS卡片中使用。 <br />**说明：**<br />从 API version 9 开始支持，从 API version 10 开始废弃，建议使用通用属性[draggable](ts-universal-events-drag-drop.md)替代。 |
 
 >  **说明：**
 >

zh-cn/application-dev/reference/arkui-ts/ts-basic-components-text.md

@@ -41,7 +41,7 @@ Text(content?: string | Resource)
 | maxFontSize             | number&nbsp;\|&nbsp;string&nbsp;\|&nbsp;[Resource](ts-types.md#resource)      | 设置文本最大显示字号。<br/>需配合minFontSize以及maxline或布局大小限制使用，单独设置不生效。 <br/>从API version 9开始，该接口支持在ArkTS卡片中使用。                                |
 | textCase                | [TextCase](ts-appendix-enums.md#textcase) | 设置文本大小写。<br />默认值：TextCase.Normal <br/>从API version 9开始，该接口支持在ArkTS卡片中使用。|
 | copyOption<sup>9+</sup> | [CopyOptions](ts-appendix-enums.md#copyoptions9) | 组件支持设置文本是否可复制粘贴。<br />默认值：CopyOptions.None <br/>该接口支持在ArkTS卡片中使用。 |
-| draggable<sup>9+</sup>  | boolean | 设置选中文本拖拽效果。<br/>不能和[onDragStart](ts-universal-events-drag-drop.md)事件同时使用；<br/>需配合copyOption一起使用，支持对选中文本的拖拽以及选中内容复制到输入框。<br/>默认值：false |
+| draggable<sup>(deprecated)</sup>  | boolean | 设置选中文本拖拽效果。<br/>不能和[onDragStart](ts-universal-events-drag-drop.md)事件同时使用；<br/>需配合copyOption一起使用，支持对选中文本的拖拽以及选中内容复制到输入框。<br/>默认值：false <br />**说明：**<br />从 API version 9 开始支持，从 API version 10 开始废弃，建议使用通用属性[draggable](ts-universal-events-drag-drop.md)替代。|
 | textShadow<sup>10+</sup> | [ShadowOptions](ts-universal-attributes-image-effect.md#shadowoptions对象说明) | 设置文字阴影效果。 |
 | heightAdaptivePolicy<sup>10+</sup> | [TextHeightAdaptivePolicy](ts-appendix-enums.md#textheightadaptivepolicy10) | 设置文本自适应高度的方式。<br/>默认值：TextHeightAdaptivePolicy.MAX_LINES_FIRST。<br/>**说明：**<br/>当设置为TextHeightAdaptivePolicy.MAX_LINES_FIRST时，优先使用`maxLines`属性来调整文本高度。如果使用`maxLines`属性的布局大小超过了布局约束，则尝试在`minFontSize`和`maxFontSize`的范围内缩小字体以显示更多文本。<br/>当设置为TextHeightAdaptivePolicy.MIN_FONT_SIZE_FIRST时，优先使用`minFontSize`属性来调整文本高度。如果使用`minFontSize`属性可以将文本布局在一行中，则尝试在`minFontSize`和`maxFontSize`的范围内增大字体并使用最大可能的字体大小。<br/>当设置为TextHeightAdaptivePolicy.LAYOUT_CONSTRAINT_FIRST时，优先使用布局约束来调整文本高度。如果布局大小超过布局约束，则尝试在`minFontSize`和`maxFontSize`的范围内缩小字体以满足布局约束。如果将字体大小缩小到`minFontSize`后，布局大小仍然超过布局约束，则删除超过布局约束的行。|
 | textIndent<sup>10+</sup> | number&nbsp;\|&nbsp;string | 设置首行文本缩进，默认值0。 |