!9197 文档整改

Merge pull request !9197 from luoying_ace/ly0905

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

@@ -34,14 +34,14 @@ TextPicker(options: {range: string[]|Resource, selected?: number, value?: string
 
 | 名称 | 参数类型 | 默认值 | 描述 |
 | -------- | -------- | -------- | -------- |
-| defaultPickerItemHeight | Length | - | 默认Picker内容项元素高度。 |
+| defaultPickerItemHeight | number \| string | - | 默认Picker内容项元素高度。 |
 
 
 ## 事件
 
 | 名称 | 描述 |
 | -------- | -------- |
-| onChange(callback:&nbsp;(value:&nbsp;string,&nbsp;index:&nbsp;number)&nbsp;=&gt;&nbsp;void) | 滑动选中TextPicker文本内容后，触发该回调。<br/>-&nbsp;value:&nbsp;当前选中项的文本。<br/>-&nbsp;index:&nbsp;当前选中项的下标。 |
+| onChange(callback:&nbsp;(value:&nbsp;string,&nbsp;index:&nbsp;number)&nbsp;=&gt;&nbsp;void) | 滑动选中TextPicker文本内容后，触发该回调。<br/>-&nbsp;value:&nbsp;当前选中项的文本。<br/>-&nbsp;index:&nbsp;当前选中项的索引值。 |
 
 
 ## 示例

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

@@ -16,7 +16,7 @@
 无
 
 
-## 接口说明
+## 接口
 
 TextTimer(options: { isCountDown?: boolean, count?: number, controller?: TextTimerController })
 

zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-longpressgesture.md

@@ -20,22 +20,17 @@ LongPressGesture(options?: { fingers?: number, repeat?: boolean, duration?: numb
   | -------- | -------- | -------- | -------- | -------- |
   | fingers | number | 否 | 1 | 触发长按的最少手指数，最小为1指， 最大取值为10指。 |
   | repeat | boolean | 否 | false | 是否连续触发事件回调。 |
-  | duration | number | 否 | 500 | 最小触发长按的时间，单位为毫秒（ms）。 |
+  | duration | number | 否 | 500 | 触发长按的最短时间，单位为毫秒（ms）。 |
 
 
 ## 事件
 
 | 名称 | 功能描述 |
 | -------- | -------- |
-| onAction((event?: GestureEvent) => void) | LongPress手势识别成功回调。 |
-| onActionEnd((event?: GestureEvent) => void) | LongPress手势识别成功，手指抬起后触发回调。 |
+| onAction((event?: [GestureEvent](ts-gesture-settings.md)) => void) | LongPress手势识别成功回调。 |
+| onActionEnd((event?: [GestureEvent](ts-gesture-settings.md)) => void) | LongPress手势识别成功，手指抬起后触发回调。 |
 | onActionCancel(event: () => void) | LongPress手势识别成功，接收到触摸取消事件触发回调。 |
 
-- GestureEvent对象中与LongPress手势相关的属性
-  | 属性名称 | 属性类型 | 描述 |
-  | -------- | -------- | -------- |
-  | repeat | boolean | 事件是否为重复触发事件。 |
-
 
 ## 示例
 

zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pangesture.md

@@ -18,21 +18,21 @@ PanGesture(options?: { fingers?: number, direction?: PanDirection, distance?: nu
 - 参数
   | 参数名称 | 参数类型 | 必填 | 默认值 | 参数描述 |
   | -------- | -------- | -------- | -------- | -------- |
-  | fingers | number | 否 | 1 | 触发滑动的最少手指数，最小为1指， 最大取值为10指。 |
-  | direction | PanDirection | 否 | All | 设置滑动方向，此枚举值支持逻辑与(&)和逻辑或（\|）运算。 |
-  | distance | number | 否 | 5.0 | 最小滑动识别距离，单位为vp。<br/>**说明：**<br/>> tab滑动与该拖动手势事件同时存在时，可将distance值设为1，使拖动更灵敏，避免造成事件错乱。 |
+  | fingers | number | 否 | 1 | 触发拖动的最少手指数，最小为1指，&nbsp;最大取值为10指。 |
+  | direction | PanDirection | 否 | PanDirection.All | 触发拖动的手势方向，此枚举值支持逻辑与(&amp;)和逻辑或（\|）运算。 |
+  | distance | number | 否 | 5.0 | 最小拖动识别距离，单位为vp。<br/>**说明：**<br/>> tab滑动与该拖动手势事件同时存在时，可将distance值设为1，使拖动更灵敏，避免造成事件错乱。 |
 
 - PanDirection枚举说明
   | 名称 | 描述 |
   | -------- | -------- |
-  | All | 所有方向可滑动。 |
-  | Horizontal | 水平方向可滑动。 |
-  | Vertical | 竖直方向可滑动。 |
-  | Left | 向左滑动。 |
-  | Right | 向右滑动。 |
-  | Up | 向上滑动。 |
-  | Down | 向下滑动。 |
-  | None | 任何方向都不可滑动。 |
+  | All | 所有方向。 |
+  | Horizontal | 水平方向。 |
+  | Vertical | 竖直方向。 |
+  | Left | 向左拖动。 |
+  | Right | 向右拖动。 |
+  | Up | 向上拖动。 |
+  | Down | 向下拖动。 |
+  | None | 任何方向都不可触发拖动手势事件。 |
 
 
 ### PanGestureOptions
@@ -56,17 +56,11 @@ PanGestureOptions(options?: { fingers?: number, direction?: PanDirection, distan
 
 | 名称 | 功能描述 |
 | -------- | -------- |
-| onActionStart(callback:&nbsp;(event?:&nbsp;GestureEvent)&nbsp;=&gt;&nbsp;void) | Pan手势识别成功回调。 |
-| onActionUpdate(callback:&nbsp;(event?:&nbsp;GestureEvent)&nbsp;=&gt;&nbsp;void) | Pan手势移动过程中回调。 |
-| onActionEnd(callback:&nbsp;(event?:&nbsp;GestureEvent)&nbsp;=&gt;&nbsp;void) | Pan手势识别成功，手指抬起后触发回调。 |
+| onActionStart(callback:&nbsp;(event?:&nbsp;[GestureEvent](ts-gesture-settings.md))&nbsp;=&gt;&nbsp;void) | Pan手势识别成功回调。 |
+| onActionUpdate(callback:&nbsp;(event?:&nbsp;[GestureEvent](ts-gesture-settings.md))&nbsp;=&gt;&nbsp;void) | Pan手势移动过程中回调。 |
+| onActionEnd(callback:&nbsp;(event?:&nbsp;[GestureEvent](ts-gesture-settings.md))&nbsp;=&gt;&nbsp;void) | Pan手势识别成功，手指抬起后触发回调。 |
 | onActionCancel(callback:&nbsp;()&nbsp;=&gt;&nbsp;void) | Pan手势识别成功，接收到触摸取消事件触发回调。 |
 
-- GestureEvent对象中与Pan手势相关的属性
-  | 属性名称 | 属性类型 | 描述 |
-  | -------- | -------- | -------- |
-  | offsetX | number | 手势事件偏移量，单位为vp。 |
-  | offsetY | number | 手势事件偏移量，单位为vp。 |
-
 
 ## 示例
 

zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pinchgesture.md

@@ -26,18 +26,11 @@ PinchGesture(options?: { fingers?: number, distance?: number })
 
 | 名称 | 功能描述 |
 | -------- | -------- |
-| onActionStart((event?: GestureEvent) => void) | Pinch手势识别成功回调。 |
-| onActionUpdate((event?: GestureEvent) => void) | Pinch手势移动过程中回调。 |
-| onActionEnd((event?: GestureEvent) => void) | Pinch手势识别成功，手指抬起后触发回调。 |
+| onActionStart((event?: [GestureEvent](ts-gesture-settings.md)) => void) | Pinch手势识别成功回调。 |
+| onActionUpdate((event?: [GestureEvent](ts-gesture-settings.md)) => void) | Pinch手势移动过程中回调。 |
+| onActionEnd((event?: [GestureEvent](ts-gesture-settings.md)) => void) | Pinch手势识别成功，手指抬起后触发回调。 |
 | onActionCancel(event: () => void) | Pinch手势识别成功，接收到触摸取消事件触发回调。 |
 
-- GestureEvent对象中与Pinch手势相关的属性
-  | 属性名称 | 属性类型 | 描述 |
-  | -------- | -------- | -------- |
-  | scale | number | 缩放比例，用于PinchGesture手势触发场景。 |
-  | pinchCenterX | number | 捏合手势中心点X轴坐标，单位为px。 |
-  | pinchCenterY | number | 捏合手势中心点Y轴坐标，单位为px。 |
-
 
 ## 示例
 

zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-rotationgesture.md

@@ -19,23 +19,18 @@ RotationGesture(options?: { fingers?: number, angle?: number })
   | 参数名称 | 参数类型 | 必填 | 默认值 | 参数描述 |
   | -------- | -------- | -------- | -------- | -------- |
   | fingers | number | 否 | 2 | 触发旋转的最少手指数, 最小为2指，最大为5指。 |
-  | angle | number | 否 | 1.0 | 触发旋转手势的最小改变度数，单位为度数。 |
+  | angle | number | 否 | 1.0 | 触发旋转手势的最小改变度数，单位为deg。 |
 
 
 ## 事件
 
 | 名称 | 功能描述 |
 | -------- | -------- |
-| onActionStart((event?: GestureEvent) => void) | Rotation手势识别成功回调。 |
-| onActionUpdate((event?: GestureEvent) => void) | Rotation手势移动过程中回调。 |
-| onActionEnd((event?: GestureEvent) => void) | Rotation手势识别成功，手指抬起后触发回调。 |
+| onActionStart((event?: [GestureEvent](ts-gesture-settings.md)) => void) | Rotation手势识别成功回调。 |
+| onActionUpdate((event?: [GestureEvent](ts-gesture-settings.md)) => void) | Rotation手势移动过程中回调。 |
+| onActionEnd((event?: [GestureEvent](ts-gesture-settings.md)) => void) | Rotation手势识别成功，手指抬起后触发回调。 |
 | onActionCancel(event: () => void) | Rotation手势识别成功，接收到触摸取消事件触发回调。 |
 
-- GestureEvent对象中与Rotation手势相关的属性
-  | 属性名称 | 属性类型 | 描述 |
-  | -------- | -------- | -------- |
-  | angle | number | 旋转角度。 |
-
 
 ## 示例
 

zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-swipegesture.md

@@ -19,8 +19,8 @@ SwipeGesture(value?: { fingers?: number; direction?: SwipeDirection; speed?: num
   | 参数名称 | 参数类型 | 必填 | 默认值 | 参数描述 |
   | -------- | -------- | -------- | -------- | -------- |
   | fingers | number | 否 | 1 | 触发滑动的最少手指数，默认为1，最小为1指，最大为10指。 |
-  | direction | SwipeDirection | 否 | SwipeDirection.All | 滑动方向。 |
-  | speed | number | 否 | 100 | 识别滑动的最小速度（100VP/秒）。 |
+  | direction | SwipeDirection | 否 | SwipeDirection.All | 触发滑动手势的滑动方向。 |
+  | speed | number | 否 | 100 | 识别滑动的最小速度（默认为100vp/秒）。 |
 
 - SwipeDirection枚举说明
   | 名称 | 描述 |
@@ -28,21 +28,16 @@ SwipeGesture(value?: { fingers?: number; direction?: SwipeDirection; speed?: num
   | All | 所有方向。 |
   | Horizontal | 水平方向。 |
   | Vertical | 竖直方向。 |
+  | None | 任何方向均不可触发。 |
 
 
 ## 事件
 
 | 名称 | 功能描述 |
 | -------- | -------- |
-| onAction(callback:(event?: GestureEvent) => void) | 滑动手势识别成功回调。 |
+| onAction(callback:(event?: [GestureEvent](ts-gesture-settings.md)) => void) | 滑动手势识别成功回调。 |
 
 
-- GestureEvent对象中与Swipe手势相关的属性
-  | 参数名 | 类型 | 说明 |
-  | -------- | -------- | -------- |
-  | angle | number | 滑动手势的角度，即两根手指间的线段与水平方向的夹角变化的度数。<br/>>&nbsp;&nbsp;**说明：**<br/>>&nbsp;角度计算方式：滑动手势被识别到后，连接两根手指之间的线被识别为起始线条，随着手指的滑动，手指之间的线条会发生旋转，根据起始线条两端点和当前线条两端点的坐标，使用反正切函数分别计算其相对于水平方向的夹角，最后arctan2(cy2-cy1,cx2-cx1)-arctan2(y2-y1,x2-x1)为旋转的角度。以起始线条为坐标系，顺时针旋转为0到180度，逆时针旋转为-180到0度。 |
-  | speed | number | 滑动手势的速度，是所有手指滑动的平均速度，单位为VP/秒。 |
-
 ![zh-cn_image_0000001231374559](figures/zh-cn_image_0000001231374661.png)
 ## 示例
 

zh-cn/application-dev/reference/arkui-ts/ts-gesture-settings.md

@@ -45,7 +45,7 @@
 
 ## 响应手势事件
 
-组件通过gesture方法绑定手势对象，可以通过手势对象提供的事件相应响应手势操作。如通过TapGesture对象的onAction事件响应点击事件。具体事件定义见各个手势对象章节。
+组件通过gesture方法绑定手势对象，可以通过手势对象提供的事件相应响应手势操作。例如通过TapGesture对象的onAction事件响应点击事件。其余手势的事件定义见各个手势对象章节。
 
 - TapGesture事件说明
   | 名称 | 功能描述 |
@@ -53,10 +53,36 @@
   | onAction((event?:GestureEvent) => void) | Tap手势识别成功回调。 |
 
 - GestureEvent对象说明
-  | 属性名称 | 属性类型 | 描述 |
+  | 名称 | 类型 | 描述 |
   | -------- | -------- | -------- |
-  | timestamp | number | 事件时间戳。 |
-  | target<sup>8+</sup> | [EventTarget](ts-universal-events-click.md) | 触发手势事件的元素对象。 |
+  | timestamp<sup>8+</sup> | number | 事件时间戳。 |
+  | target<sup>8+</sup> | [EventTarget](ts-universal-events-click.md) | 触发手势事件的元素对象显示区域。 |
+  | source<sup>8+</sup> | SourceType | 事件输入设备。 |
+  | repeat | boolean | 是否为重复触发事件，用于LongPressGesture手势触发场景。 |
+  | fingerList<sup>8+</sup> | FingerInfo[] | 触发事件的所有手指信息，用于LongPressGesture与TapGesture手势触发场景。 |
+  | offsetX | number | 手势事件x轴偏移量，单位为vp，用于PanGesture手势触发场景。 |
+  | offsetY | number | 手势事件y轴偏移量，单位为vp，用于PanGesture手势触发场景。 |
+  | angle | number | 用于RotationGesture手势触发场景时，表示旋转角度；用于SwipeGesture手势触发场景时，表示滑动手势的角度，即两根手指间的线段与水平方向的夹角变化的度数。<br/>>&nbsp;&nbsp;**说明：**<br/>>&nbsp;角度计算方式：滑动手势被识别到后，连接两根手指之间的线被识别为起始线条，随着手指的滑动，手指之间的线条会发生旋转，根据起始线条两端点和当前线条两端点的坐标，使用反正切函数分别计算其相对于水平方向的夹角，最后arctan2(cy2-cy1,cx2-cx1)-arctan2(y2-y1,x2-x1)为旋转的角度。以起始线条为坐标系，顺时针旋转为0到180度，逆时针旋转为-180到0度。 |
+  | speed<sup>8+</sup> | number | 滑动手势速度，即所有手指滑动的平均速度，单位为vp/秒，用于SwipeGesture手势触发场景。 |
+  | scale | number | 缩放比例，用于PinchGesture手势触发场景。 |
+  | pinchCenterX | number | 捏合手势中心点x轴坐标，单位为vp，用于PinchGesture手势触发场景。 |
+  | pinchCenterY | number | 捏合手势中心点y轴坐标，单位为vp，用于PinchGesture手势触发场景。 |
+  
+- SourceType
+  | 名称 | 描述 |
+  | -------- | -------- |
+  | Unknown | 未知设备。 |
+  | Mouse | 鼠标。 |
+  | TouchScreen | 触摸屏。 |
+
+- FingerInfo对象说明
+  | 名称 | 类型 | 描述 |
+  | -------- | -------- | -------- |
+  | id | number | 手指的索引编号。 |
+  | globalX | number | 相对于设备屏幕左上角的x轴坐标。 |
+  | globalY | number | 相对于设备屏幕左上角的y轴坐标。 |
+  | localX | number | 相对于当前组件元素左上角的x轴坐标。 |
+  | localY | number | 相对于当前组件元素左上角的y轴坐标。 |
 
 
 ## 示例

zh-cn/application-dev/reference/arkui-ts/ts-methods-textpicker-dialog.md

@@ -22,7 +22,7 @@ show(options: TextPickerDialogOptions)
   | range | string[] | 是 | - | 选择器的数据选择范围。 |
   | selected | number | 否 | 0 | 选中项在数组中的index值。 |
   | value       | string           | 否    | -    | 选中项文本值。当设置了selected参数时，该值不生效。如果该值不在range范围内，则默认取range第一个元素。|
-  | defaultPickerItemHeight | number | 否 | - | 默认Picker内容项元素高度。 |
+  | defaultPickerItemHeight | number \| string | 否 | - | 默认Picker内容项元素高度。 |
   | onAccept | (value: TextPickerResult) => void | 否 | - | 点击弹窗中确定按钮时触发。 |
   | onCancel | () => void | 否 | - | 点击弹窗中取消按钮时触发。 |
   | onChange | (value: TextPickerResult) => void | 否 | - | 滑动选择器，当前选择项改变时触发。 |