diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textpicker.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textpicker.md
index 0b1e6ead8cb0d9f73e389fb7e4f267eb982a4b30..26420788263bce128976beeb10a192da17775e67 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textpicker.md
+++ b/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: (value: string, index: number) => void) | 滑动选中TextPicker文本内容后,触发该回调。
- value: 当前选中项的文本。
- index: 当前选中项的下标。 |
+| onChange(callback: (value: string, index: number) => void) | 滑动选中TextPicker文本内容后,触发该回调。
- value: 当前选中项的文本。
- index: 当前选中项的索引值。 |
## 示例
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-texttimer.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-texttimer.md
index aa0e3b67c193e262606c133e2e76c697605be3cc..9045b38cd0d6909c30625a4f4f824d2464e7ea69 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-texttimer.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-texttimer.md
@@ -16,7 +16,7 @@
无
-## 接口说明
+## 接口
TextTimer(options: { isCountDown?: boolean, count?: number, controller?: TextTimerController })
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-longpressgesture.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-longpressgesture.md
index 07048ee142ba9a6a69ca930e6f24bdc86ddd1b45..8e989cfd35eda60a6fd9876b32d9e81aa8d7a956 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-longpressgesture.md
+++ b/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 | 事件是否为重复触发事件。 |
-
## 示例
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pangesture.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pangesture.md
index 7939fba7352e40b25d9ee36f2dfa937eb95a0972..ace70efd0f55bf320fb239595eb266e4d95c15e6 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pangesture.md
+++ b/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。
**说明:**
> tab滑动与该拖动手势事件同时存在时,可将distance值设为1,使拖动更灵敏,避免造成事件错乱。 |
+ | fingers | number | 否 | 1 | 触发拖动的最少手指数,最小为1指, 最大取值为10指。 |
+ | direction | PanDirection | 否 | PanDirection.All | 触发拖动的手势方向,此枚举值支持逻辑与(&)和逻辑或(\|)运算。 |
+ | distance | number | 否 | 5.0 | 最小拖动识别距离,单位为vp。
**说明:**
> 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: (event?: GestureEvent) => void) | Pan手势识别成功回调。 |
-| onActionUpdate(callback: (event?: GestureEvent) => void) | Pan手势移动过程中回调。 |
-| onActionEnd(callback: (event?: GestureEvent) => void) | Pan手势识别成功,手指抬起后触发回调。 |
+| onActionStart(callback: (event?: [GestureEvent](ts-gesture-settings.md)) => void) | Pan手势识别成功回调。 |
+| onActionUpdate(callback: (event?: [GestureEvent](ts-gesture-settings.md)) => void) | Pan手势移动过程中回调。 |
+| onActionEnd(callback: (event?: [GestureEvent](ts-gesture-settings.md)) => void) | Pan手势识别成功,手指抬起后触发回调。 |
| onActionCancel(callback: () => void) | Pan手势识别成功,接收到触摸取消事件触发回调。 |
-- GestureEvent对象中与Pan手势相关的属性
- | 属性名称 | 属性类型 | 描述 |
- | -------- | -------- | -------- |
- | offsetX | number | 手势事件偏移量,单位为vp。 |
- | offsetY | number | 手势事件偏移量,单位为vp。 |
-
## 示例
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pinchgesture.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pinchgesture.md
index d55eb0105e3ab4ff05f8b12c0169b73e8c44d702..7bbffc2f14173874c3adb81b007c55fc408dfaf0 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pinchgesture.md
+++ b/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。 |
-
## 示例
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-rotationgesture.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-rotationgesture.md
index 46a41b500b670f2b8d6f10aec9ced5cf111ea6ae..cec499078b110b3e2e336facb425ffe7e6990b52 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-rotationgesture.md
+++ b/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 | 旋转角度。 |
-
## 示例
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-swipegesture.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-swipegesture.md
index e50e47a0fec6e79bcfae4ce58548d76a4d721f7f..384f7940c0f9315e69af27a503fb1d177cdb0553 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-swipegesture.md
+++ b/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 | 滑动手势的角度,即两根手指间的线段与水平方向的夹角变化的度数。
> **说明:**
> 角度计算方式:滑动手势被识别到后,连接两根手指之间的线被识别为起始线条,随着手指的滑动,手指之间的线条会发生旋转,根据起始线条两端点和当前线条两端点的坐标,使用反正切函数分别计算其相对于水平方向的夹角,最后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)
## 示例
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-gesture-settings.md b/zh-cn/application-dev/reference/arkui-ts/ts-gesture-settings.md
index dab1454385102a4f6ebbbb66456890008ee79860..31571927efafe26c33abdd83139da9c3eb7db932 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-gesture-settings.md
+++ b/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 | 事件时间戳。 |
- | target8+ | [EventTarget](ts-universal-events-click.md) | 触发手势事件的元素对象。 |
+ | timestamp8+ | number | 事件时间戳。 |
+ | target8+ | [EventTarget](ts-universal-events-click.md) | 触发手势事件的元素对象显示区域。 |
+ | source8+ | SourceType | 事件输入设备。 |
+ | repeat | boolean | 是否为重复触发事件,用于LongPressGesture手势触发场景。 |
+ | fingerList8+ | FingerInfo[] | 触发事件的所有手指信息,用于LongPressGesture与TapGesture手势触发场景。 |
+ | offsetX | number | 手势事件x轴偏移量,单位为vp,用于PanGesture手势触发场景。 |
+ | offsetY | number | 手势事件y轴偏移量,单位为vp,用于PanGesture手势触发场景。 |
+ | angle | number | 用于RotationGesture手势触发场景时,表示旋转角度;用于SwipeGesture手势触发场景时,表示滑动手势的角度,即两根手指间的线段与水平方向的夹角变化的度数。
> **说明:**
> 角度计算方式:滑动手势被识别到后,连接两根手指之间的线被识别为起始线条,随着手指的滑动,手指之间的线条会发生旋转,根据起始线条两端点和当前线条两端点的坐标,使用反正切函数分别计算其相对于水平方向的夹角,最后arctan2(cy2-cy1,cx2-cx1)-arctan2(y2-y1,x2-x1)为旋转的角度。以起始线条为坐标系,顺时针旋转为0到180度,逆时针旋转为-180到0度。 |
+ | speed8+ | 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轴坐标。 |
## 示例
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-methods-textpicker-dialog.md b/zh-cn/application-dev/reference/arkui-ts/ts-methods-textpicker-dialog.md
index b5d516dd4065bad8d2694fdfbde420ee65d5c9a4..784ba9c62707d833125cc77684ff3af2b998aaa0 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-methods-textpicker-dialog.md
+++ b/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 | 否 | - | 滑动选择器,当前选择项改变时触发。 |