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 | 否 | - | 滑动选择器，当前选择项改变时触发。 |