update docs

Signed-off-by: N HelloCrease <lian15@huawei.com>

update docs
Signed-off-by: N HelloCrease <lian15@huawei.com>
00968439 · HelloCrease · 15d285eb · 00968439 · 00968439 · 00968439
5 changed file
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-click.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-click.md
 # 点击事件

-> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
-> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+>  **说明：**
+>  从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。


 ## 权限列表
@@ -11,43 +11,44 @@

 ## 事件

-| 名称 | 支持冒泡 | 功能描述 | 
-| -------- | -------- | -------- |
-| onClick(callback:&nbsp;(event?:&nbsp;ClickEvent)&nbsp;=&gt;&nbsp;void) | 否 | 点击动作触发该方法调用，event参数见ClickEvent介绍。 | 
-
-### ClickEvent对象说明
-  | 属性名称 | 类型 | 描述 |
-  | -------- | -------- | -------- |
-  | screenX | number | 点击点相对于设备屏幕左边沿的X坐标。 |
-  | screenY | number | 点击点相对于设备屏幕上边沿的Y坐标。 |
-  | x | number | 点击点相对于被点击元素左边沿的X坐标。 |
-  | y | number | 点击点相对于被点击元素上边沿的Y坐标。 |
-  | target<sup>8+</sup> | EventTarget | 被点击元素对象。 |
-  | timestamp | number | 事件时间戳。 |
-
- EventTarget<sup>8+</sup>对象说明
-  | 名称 | 参数类型 | 描述 |
-  | -------- | -------- | -------- |
-  | area | Area | 目标元素的区域信息。 |
-
- Area<sup>8+</sup>对象说明
-  | 属性名称 | 类型 | 描述 |
-  | -------- | -------- | -------- |
-  | width | number | 目标元素的宽度，单位为vp。 |
-  | height | number | 目标元素的高度，单位为vp。 |
-  | position | Position | 目标元素左上角相对父元素左上角的位置。 |
-  | globalPosition | Position | 目标元素左上角相对页面左上角的位置。 |
-
- Position<sup>8+</sup>对象说明
-  | 属性名称 | 参数类型 | 描述 | 
-  | -------- | -------- | -------- |
-  | x | number | x轴坐标，单位为vp。 | 
-  | y | number | y轴坐标，单位为vp。 | 
+| 名称                                       | 支持冒泡 | 功能描述                              |
+| ---------------------------------------- | ---- | --------------------------------- |
+| onClick(callback:&nbsp;(event?:&nbsp;ClickEvent)&nbsp;=&gt;&nbsp;void) | 否    | 点击动作触发该方法调用，event参数见ClickEvent介绍。 |
+
+## ClickEvent对象说明
+| 属性名称                | 类型                               | 描述                  |
+| ------------------- | -------------------------------- | ------------------- |
+| screenX             | number                           | 点击点相对于设备屏幕左边沿的X坐标。  |
+| screenY             | number                           | 点击点相对于设备屏幕上边沿的Y坐标。  |
+| x                   | number                           | 点击点相对于被点击元素左边沿的X坐标。 |
+| y                   | number                           | 点击点相对于被点击元素上边沿的Y坐标。 |
+| target<sup>8+</sup> | [EventTarget](#eventtarget8对象说明) | 被点击元素对象。            |
+| timestamp           | number                           | 事件时间戳。              |
+
+## EventTarget<sup>8+</sup>对象说明
+| 名称   | 参数类型              | 描述         |
+| ---- | ----------------- | ---------- |
+| area | [Area](Area8对象说明) | 目标元素的区域信息。 |
+
+## Area<sup>8+</sup>对象说明
+| 属性名称           | 类型                         | 描述                  |
+| -------------- | -------------------------- | ------------------- |
+| width          | number                     | 目标元素的宽度，单位为vp。      |
+| height         | number                     | 目标元素的高度，单位为vp。      |
+| position       | [Position](#position8对象说明) | 目标元素左上角相对父元素左上角的位置。 |
+| globalPosition | [Position](#position8对象说明) | 目标元素左上角相对页面左上角的位置。  |
+
+## Position<sup>8+</sup>对象说明
+| 属性名称 | 参数类型   | 描述          |
+| ---- | ------ | ----------- |
+| x    | number | x轴坐标，单位为vp。 |
+| y    | number | y轴坐标，单位为vp。 |


 ## 示例

-```
+```ts
+// xxx.ets
 @Entry
 @Component
 struct ClickExample {

--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-drag-drop.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-drag-drop.md
 # 拖拽事件

-> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
-> 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+>  **说明：**
+>  从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

 ## 事件

-| 名称 | 支持冒泡 | 功能描述 |
-| -------- | -------- | -------- |
-| onDragStart(callback:&nbsp;(event:&nbsp;DragEvent,&nbsp;extraParams?:&nbsp;string)&nbsp;=&gt;&nbsp;&nbsp;[CustomBuilder](../../ui/ts-types.md)) | 否 | 第一次拖拽此事件绑定的组件时，触发回调。<br/>event：拖拽事件信息，包括拖拽点坐标。<br/>extraParams：拖拽事件额外信息，详见extraParam类型描述。<br/>返回值：当前跟手效果所拖拽的对象，用于显示拖拽时的提示组件。<br/>>&nbsp;![icon-note.gif](public_sys-resources/icon-note.gif)&nbsp;**说明：**<br/>>&nbsp;-&nbsp;长按150毫秒(ms)可触发拖拽事件。<br/>>&nbsp;-&nbsp;优先级：长按手势配置时间小于等于150毫秒(ms)时，长按手势优先触发，否则拖拽事件优先触发。 |
-| onDragEnter(callback:&nbsp;(event:&nbsp;DragEvent,&nbsp;extraParams?:&nbsp;string)&nbsp;=&gt;&nbsp;void) | 否 | 拖拽进入组件范围内时，触发回调。<br/>event：拖拽事件信息，包括拖拽点坐标。<br/>extraParams：拖拽事件额外信息，详见extraParam类型描述。<br/>>&nbsp;![icon-note.gif](public_sys-resources/icon-note.gif)&nbsp;**说明：**<br/>>&nbsp;当监听了onDrop事件时，此事件才有效。 |
-| onDragMove(callback:&nbsp;(event:&nbsp;DragEvent,&nbsp;extraParams?:&nbsp;string)&nbsp;=&gt;&nbsp;void) | 否 | 拖拽在组件范围内移动时，触发回调。<br/>event：拖拽事件信息，包括拖拽点坐标。<br/>extraParams：拖拽事件额外信息，详见extraParam类型描述。<br/>>&nbsp;![icon-note.gif](public_sys-resources/icon-note.gif)&nbsp;**说明：**<br/>>&nbsp;当监听了onDrop事件时，此事件才有效。 |
-| onDragLeave(callback:&nbsp;(event:&nbsp;DragEvent,&nbsp;extraParams?:&nbsp;string)&nbsp;=&gt;&nbsp;void) | 否 | 拖拽离开组件范围内时，触发回调。<br/>event：拖拽事件信息，包括拖拽点坐标。<br/>extraParams：拖拽事件额外信息，详见extraParam类型描述。<br/>>&nbsp;![icon-note.gif](public_sys-resources/icon-note.gif)&nbsp;**说明：**<br/>>&nbsp;当监听了onDrop事件时，此事件才有效。 |
-| onDrop(callback:&nbsp;(event:&nbsp;DragEvent,&nbsp;extraParams?:&nbsp;string)&nbsp;=&gt;&nbsp;void) | 否 | 绑定此事件的组件可作为拖拽释放目标，当在本组件范围内停止拖拽行为时，触发回调。<br/>event：拖拽事件信息，包括拖拽点坐标。<br/>extraParams：拖拽事件额外信息，详见extraParam类型描述。 |
+| 名称                                       | 支持冒泡 | 功能描述                                     |
+| ---------------------------------------- | ---- | ---------------------------------------- |
+| onDragStart(callback:&nbsp;(event:&nbsp;DragEvent,&nbsp;extraParams?:&nbsp;string)&nbsp;=&gt;&nbsp;&nbsp;[CustomBuilder](../../ui/ts-types.md)) | 否    | 第一次拖拽此事件绑定的组件时，触发回调。<br/>- event：拖拽事件信息，包括拖拽点坐标。<br/>- extraParams：拖拽事件额外信息，详见extraParam类型描述。<br/>返回值：当前跟手效果所拖拽的对象，用于显示拖拽时的提示组件。<br/>长按150毫秒(ms)可触发拖拽事件。优先级：长按手势配置时间小于等于150毫秒(ms)时，长按手势优先触发，否则拖拽事件优先触发。 |
+| onDragEnter(callback:&nbsp;(event:&nbsp;DragEvent,&nbsp;extraParams?:&nbsp;string)&nbsp;=&gt;&nbsp;void) | 否    | 拖拽进入组件范围内时，触发回调。<br/>- event：拖拽事件信息，包括拖拽点坐标。<br/>- extraParams：拖拽事件额外信息，详见extraParam类型描述。<br/>当监听了onDrop事件时，此事件才有效。 |
+| onDragMove(callback:&nbsp;(event:&nbsp;DragEvent,&nbsp;extraParams?:&nbsp;string)&nbsp;=&gt;&nbsp;void) | 否    | 拖拽在组件范围内移动时，触发回调。<br/>- event：拖拽事件信息，包括拖拽点坐标。<br/>- extraParams：拖拽事件额外信息，详见extraParam类型描述。<br/>当监听了onDrop事件时，此事件才有效。 |
+| onDragLeave(callback:&nbsp;(event:&nbsp;DragEvent,&nbsp;extraParams?:&nbsp;string)&nbsp;=&gt;&nbsp;void) | 否    | 拖拽离开组件范围内时，触发回调。<br/>- event：拖拽事件信息，包括拖拽点坐标。<br/>- extraParams：拖拽事件额外信息，详见extraParam类型描述。<br/>当监听了onDrop事件时，此事件才有效。 |
+| onDrop(callback:&nbsp;(event:&nbsp;DragEvent,&nbsp;extraParams?:&nbsp;string)&nbsp;=&gt;&nbsp;void) | 否    | 绑定此事件的组件可作为拖拽释放目标，当在本组件范围内停止拖拽行为时，触发回调。<br/>- event：拖拽事件信息，包括拖拽点坐标。<br/>- extraParams：拖拽事件额外信息，详见extraParam类型描述。 |

 - extraParam说明<br>
  用于返回组件在拖拽中需要用到的额外信息。
  extraParam是Json对象转换的string字符串，可以通过Json.parse转换的Json对象获取如下属性。
-  | 属性名称 | 属性类型 | 描述 | 
-  | -------- | -------- | -------- |
-  | selectedIndex | number | 当拖拽事件设在父容器的子元素时，selectedIndex表示当前被拖拽子元素是父容器第selectedIndex个子元素，selectedIndex从0开始。<br/>>&nbsp;![icon-note.gif](public_sys-resources/icon-note.gif)&nbsp;**说明：**<br/>>&nbsp;仅在ListItem组件中生效。 | 
-  | insertIndex | number | 当前拖拽元素在List组件中放下时，insertIndex表示被拖拽元素插入该组件的第insertIndex个位置，insertIndex从0开始。<br/>>&nbsp;![icon-note.gif](public_sys-resources/icon-note.gif)&nbsp;**说明：**<br/>>&nbsp;仅在List组件的拖拽事件中生效。 | 
+  | 属性名称          | 属性类型   | 描述                                       |
+  | ------------- | ------ | ---------------------------------------- |
+  | selectedIndex | number | 当拖拽事件设在父容器的子元素时，selectedIndex表示当前被拖拽子元素是父容器第selectedIndex个子元素，selectedIndex从0开始。<br/>仅在ListItem组件中生效。 |
+  | insertIndex   | number | 当前拖拽元素在List组件中放下时，insertIndex表示被拖拽元素插入该组件的第insertIndex个位置，insertIndex从0开始。<br/>仅在List组件的拖拽事件中生效。 |

 ### DragEvent对象说明
- 接口
-  | 名称 | 返回值类型 | 功能描述 | 
-  | -------- | -------- | -------- |
-  | getX() | number | 当前拖拽点x轴坐标，单位为vp。 | 
-  | getY() | number | 当前拖拽点y轴坐标，单位为vp。 | 
-
+| 名称     | 返回值类型  | 功能描述             |
+| ------ | ------ | ---------------- |
+| getX() | number | 当前拖拽点x轴坐标，单位为vp。 |
+| getY() | number | 当前拖拽点y轴坐标，单位为vp。 |

 ## 示例

-```
+```ts
+// xxx.ets
 @Entry
 @Component
 struct DragExample {

--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-key.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-key.md
 # 按键事件

-> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
-> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+>  **说明：**
+>  从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。


 ## 权限列表
@@ -11,58 +11,59 @@

 ## 事件

-| 名称 | 支持冒泡 | 功能描述 | 
-| -------- | -------- | -------- |
-| onKeyEvent(event:&nbsp;(event?:&nbsp;KeyEvent)&nbsp;=&gt;&nbsp;void) | 是 | 按键动作触发该方法调用，event参数见[KeyEvent](#keyevent对象说明)介绍。 | 
+| 名称                                       | 支持冒泡 | 功能描述                                     |
+| ---------------------------------------- | ---- | ---------------------------------------- |
+| onKeyEvent(event:&nbsp;(event?:&nbsp;KeyEvent)&nbsp;=&gt;&nbsp;void) | 是    | 按键动作触发该方法调用，event参数见[KeyEvent](#keyevent对象说明)介绍。 |


-### KeyEvent对象说明
+## KeyEvent对象说明

 - 属性
-  | 属性名称 | 类型 | 描述 |
-  | -------- | -------- | -------- |
-  | type | KeyType | 按键的类型。 |
-  | keyCode | number | 按键的键码。 |
-  | keyText | string | 按键的键值。 |
-  | keySource | KeySource | 触发当前按键的输入设备类型。 |
-  | deviceId | number | 触发当前按键的输入设备ID。 |
-  | metaKey | number | 按键发生时元键的状态，1表示按压态，0表示未按压态。 |
-  | timestamp | number | 按键发生时的时间戳。 |
+  | 属性名称      | 类型                          | 描述                         |
+  | --------- | --------------------------- | -------------------------- |
+  | type      | [KeyType](#keytype枚举说明)     | 按键的类型。                     |
+  | keyCode   | number                      | 按键的键码。                     |
+  | keyText   | string                      | 按键的键值。                     |
+  | keySource | [KeySource](#keysource枚举说明) | 触发当前按键的输入设备类型。             |
+  | deviceId  | number                      | 触发当前按键的输入设备ID。             |
+  | metaKey   | number                      | 按键发生时元键的状态，1表示按压态，0表示未按压态。 |
+  | timestamp | number                      | 按键发生时的时间戳。                 |


 - 接口
-  | 接口名称 | 功能描述 | 
-  | -------- | -------- |
-  | stopPropagation():&nbsp;void | 阻塞事件冒泡传递。 | 
-
- KeyType枚举说明
-  | 名称 | 描述 | 
-  | -------- | -------- |
-  | Down | 按键按下。 | 
-  | Up | 按键松开。 | 
-
-
- KeySource枚举说明
-  | 名称 | 描述 | 
-  | -------- | -------- |
-  | Unknown | 输入设备类型未知。 | 
-  | Keyboard | 输入设备类型为键盘。 | 
-
- 常用KeyCode说明
-  | 数值 | 行为 | 物理按键 | 
-  | -------- | -------- | -------- |
-  | 19 | 上 | 向上方向键。 | 
-  | 20 | 下 | 向下方向键。 | 
-  | 21 | 左 | 向左方向键。 | 
-  | 22 | 右 | 向右方向键。 | 
-  | 23 | 确定 | 遥控器的确认键。 | 
-  | 66 | 确定 | 键盘的回车键。 | 
-  | 160 | 确定 | 键盘的小键盘回车键。 | 
+  | 接口名称                         | 功能描述      |
+  | ---------------------------- | --------- |
+  | stopPropagation():&nbsp;void | 阻塞事件冒泡传递。 |
+
+## KeyType枚举说明
+| 名称   | 描述    |
+| ---- | ----- |
+| Down | 按键按下。 |
+| Up   | 按键松开。 |
+
+
+## KeySource枚举说明
+| 名称                      | 描述         |
+| ----------------------- | ---------- |
+| Unknown                 | 输入设备类型未知。  |
+| [KeyCode](#常用keycode说明) | 输入设备类型为键盘。 |
+
+## 常用KeyCode说明
+| 数值   | 行为   | 物理按键       |
+| ---- | ---- | ---------- |
+| 19   | 上    | 向上方向键。     |
+| 20   | 下    | 向下方向键。     |
+| 21   | 左    | 向左方向键。     |
+| 22   | 右    | 向右方向键。     |
+| 23   | 确定   | 遥控器的确认键。   |
+| 66   | 确定   | 键盘的回车键。    |
+| 160  | 确定   | 键盘的小键盘回车键。 |


 ## 示例

-```
+```ts
+// xxx.ets
 @Entry
 @Component
 struct KeyEventExample {

--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-touch.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-touch.md
 # 触摸事件

-> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
+> **说明：**
 > 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。


@@ -11,52 +11,53 @@

 ## 事件

-| 名称 | 是否冒泡 | 功能描述 | 
-| -------- | -------- | -------- |
-| onTouch(callback:&nbsp;(event?:&nbsp;TouchEvent)&nbsp;=&gt;&nbsp;void) | 是 | 触摸动作触发该方法调用，event参数见[TouchEvent](#touchevent对象说明)介绍。 
+| 名称                                       | 是否冒泡 | 功能描述                                     |
+| ---------------------------------------- | ---- | ---------------------------------------- |
+| onTouch(callback:&nbsp;(event?:&nbsp;TouchEvent)&nbsp;=&gt;&nbsp;void) | 是    | 触摸动作触发该方法调用，event参数见[TouchEvent](#touchevent对象说明)介绍。 |


-### TouchEvent对象说明
+## TouchEvent对象说明

 - 属性
-  | 属性名称 | 类型 | 描述 |
-  | -------- | -------- | -------- |
-  | type | TouchType | 触摸事件的类型。 |
-  | touches | ArrayTouchObject&gt; | 全部手指信息。 |
-  | changedTouches | ArrayTouchObject&gt; | 当前发生变化的手指信息。 |
-  | timestamp | number | 事件时间戳。 |
-  | target<sup>8+</sup> | [EventTarget](ts-universal-events-click.md)| 被触摸元素对象。 |
+  | 属性名称                | 类型                                       | 描述           |
+  | ------------------- | ---------------------------------------- | ------------ |
+  | type                | TouchType                                | 触摸事件的类型。     |
+  | touches             | Array&lt;[TouchObject](touchobject对象说明)&gt; | 全部手指信息。      |
+  | changedTouches      | Array&lt;[TouchObject](touchobject对象说明)&gt; | 当前发生变化的手指信息。 |
+  | timestamp           | number                                   | 事件时间戳。       |
+  | target<sup>8+</sup> | [EventTarget](ts-universal-events-click.md) | 被触摸元素对象。     |


 - 接口
-  | 接口名称 | 功能描述 | 
-  | -------- | -------- |
-  | stopPropagation()：void | 阻塞事件冒泡。 | 
+  | 接口名称                   | 功能描述    |
+  | ---------------------- | ------- |
+  | stopPropagation()：void | 阻塞事件冒泡。 |


- TouchObject对象说明
-  | 属性名称 | 类型 | 描述 |
-  | -------- | -------- | -------- |
-  | type | TouchType | 触摸事件的类型。 |
-  | id | number | 手指唯一标识符。 |
-  | screenX | number | 触摸点相对于设备屏幕左边沿的X坐标。 |
-  | screenY | number | 触摸点相对于设备屏幕上边沿的Y坐标。 |
-  | x | number | 触摸点相对于被触摸元素左边沿的X坐标。 |
-  | y | number | 触摸点相对于被触摸元素上边沿的Y坐标。 |
+## TouchObject对象说明
+| 属性名称    | 类型                          | 描述                  |
+| ------- | --------------------------- | ------------------- |
+| type    | [TouchType](#touchtype枚举说明) | 触摸事件的类型。            |
+| id      | number                      | 手指唯一标识符。            |
+| screenX | number                      | 触摸点相对于设备屏幕左边沿的X坐标。  |
+| screenY | number                      | 触摸点相对于设备屏幕上边沿的Y坐标。  |
+| x       | number                      | 触摸点相对于被触摸元素左边沿的X坐标。 |
+| y       | number                      | 触摸点相对于被触摸元素上边沿的Y坐标。 |


- TouchType枚举说明
-  | 名称 | 描述 | 
-  | -------- | -------- |
-  | Down | 手指按下时触发。 | 
-  | Up | 手指抬起时触发。 | 
-  | Move | 手指按压态在屏幕上移动时触发。 | 
-  | Cancel | 触摸事件取消时触发。 | 
+## TouchType枚举说明
+| 名称     | 描述              |
+| ------ | --------------- |
+| Down   | 手指按下时触发。        |
+| Up     | 手指抬起时触发。        |
+| Move   | 手指按压态在屏幕上移动时触发。 |
+| Cancel | 触摸事件取消时触发。      |


 ## 示例

-```
+```ts
+// xxx.ets
 @Entry
 @Component
 struct TouchExample {

--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-mouse-key.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-mouse-key.md
 # 鼠标事件

-> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
-> 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+>  **说明：**
+>  从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。


 ## 权限列表
@@ -11,45 +11,46 @@

 ## 事件

-| 名称 | 支持冒泡 | 描述 |
-| -------- | -------- | -------- |
-| onHover(callback:&nbsp;(isHover:&nbsp;boolean)&nbsp;=&gt;&nbsp;void) | 否 | 鼠标进入或退出组件时触发该回调。<br/>isHover：表示鼠标是否悬浮在组件上，鼠标进入时为true,&nbsp;退出时为false。 |
-| onMouse(callback:&nbsp;(event?:&nbsp;MouseEvent)&nbsp;=&gt;&nbsp;void) | 是 | 当前组件被鼠标按键点击时或者鼠标在组件上移动时，触发该回调，event参数包含触发事件时的时间戳、鼠标按键、动作、点击触点在整个屏幕上的坐标和点击触点相对于当前组件的坐标。 |
-
-
-### MouseEvent对象说明
-  | 属性名称 | 属性类型 | 描述 |
-  | -------- | -------- | -------- |
-  | timestamp | number | 触发事件时的时间戳。 |
-  | screenX | number | 点击触点相对于屏幕左上角的x轴坐标。 |
-  | screenY | number | 点击触点相对于屏幕左上角的y轴坐标。 |
-  | x | number | 点击触点相对于当前组件左上角的x轴坐标。 |
-  | y | number | 点击触点相对于当前组件左上角的y轴坐标。 |
-  | button | MouseButton | 鼠标按键。 |
-  | action | MouseAction | 事件动作。 |
-
-
- MouseButton类型说明
-  | 属性名称 | 属性类型 | 描述 | 
-  | -------- | -------- | -------- |
-  | Left | number | 鼠标左键。 | 
-  | Right | number | 鼠标右键。 | 
-  | Middle | number | 鼠标中键。 | 
-  | Back | number | 鼠标左侧后退键。 | 
-  | Forward | number | 鼠标左侧前进键。 | 
-  | None | number | 无按键。 | 
-
- MouseAction类型说明
-  | 属性名称 | 属性类型 | 描述 | 
-  | -------- | -------- | -------- |
-  | Press | number | 鼠标按键按下。 | 
-  | Release | number | 鼠标按键松开。 | 
-  | Move | number | 鼠标移动。 | 
+| 名称                                       | 支持冒泡 | 描述                                       |
+| ---------------------------------------- | ---- | ---------------------------------------- |
+| onHover(callback:&nbsp;(isHover:&nbsp;boolean)&nbsp;=&gt;&nbsp;void) | 否    | 鼠标进入或退出组件时触发该回调。<br/>isHover：表示鼠标是否悬浮在组件上，鼠标进入时为true,&nbsp;退出时为false。 |
+| onMouse(callback:&nbsp;(event?:&nbsp;MouseEvent)&nbsp;=&gt;&nbsp;void) | 是    | 当前组件被鼠标按键点击时或者鼠标在组件上移动时，触发该回调，event参数包含触发事件时的时间戳、鼠标按键、动作、点击触点在整个屏幕上的坐标和点击触点相对于当前组件的坐标。 |
+
+
+## MouseEvent对象说明
+| 属性名称      | 属性类型                            | 描述                   |
+| --------- | ------------------------------- | -------------------- |
+| timestamp | number                          | 触发事件时的时间戳。           |
+| screenX   | number                          | 点击触点相对于屏幕左上角的x轴坐标。   |
+| screenY   | number                          | 点击触点相对于屏幕左上角的y轴坐标。   |
+| x         | number                          | 点击触点相对于当前组件左上角的x轴坐标。 |
+| y         | number                          | 点击触点相对于当前组件左上角的y轴坐标。 |
+| button    | [MouseButton](#mousebutton类型说明) | 鼠标按键。                |
+| action    | [MouseAction](#mouseaction类型说明) | 事件动作。                |
+
+
+## MouseButton类型说明
+| 属性名称    | 属性类型   | 描述       |
+| ------- | ------ | -------- |
+| Left    | number | 鼠标左键。    |
+| Right   | number | 鼠标右键。    |
+| Middle  | number | 鼠标中键。    |
+| Back    | number | 鼠标左侧后退键。 |
+| Forward | number | 鼠标左侧前进键。 |
+| None    | number | 无按键。     |
+
+## MouseAction类型说明
+| 属性名称    | 属性类型   | 描述      |
+| ------- | ------ | ------- |
+| Press   | number | 鼠标按键按下。 |
+| Release | number | 鼠标按键松开。 |
+| Move    | number | 鼠标移动。   |


 ## 示例

-```
+```ts
+// xxx.ets
 @Entry
 @Component
 struct MouseEventExample {