Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
7ad246f6
D
Docs
项目概览
OpenHarmony
/
Docs
大约 2 年 前同步成功
通知
161
Star
293
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
7ad246f6
编写于
9月 07, 2022
作者:
L
luoying_ace_admin
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
fix docs
Signed-off-by:
N
luoying_ace_admin
<
luoying19@huawei.com
>
上级
fc6693cc
变更
9
显示空白变更内容
内联
并排
Showing
9 changed file
with
113 addition
and
114 deletion
+113
-114
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textpicker.md
...-dev/reference/arkui-ts/ts-basic-components-textpicker.md
+1
-1
zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-longpressgesture.md
.../reference/arkui-ts/ts-basic-gestures-longpressgesture.md
+10
-15
zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pangesture.md
...on-dev/reference/arkui-ts/ts-basic-gestures-pangesture.md
+28
-33
zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pinchgesture.md
...-dev/reference/arkui-ts/ts-basic-gestures-pinchgesture.md
+10
-17
zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-rotationgesture.md
...v/reference/arkui-ts/ts-basic-gestures-rotationgesture.md
+10
-15
zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-swipegesture.md
...-dev/reference/arkui-ts/ts-basic-gestures-swipegesture.md
+16
-21
zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-tapgesture.md
...on-dev/reference/arkui-ts/ts-basic-gestures-tapgesture.md
+7
-7
zh-cn/application-dev/reference/arkui-ts/ts-gesture-settings.md
...application-dev/reference/arkui-ts/ts-gesture-settings.md
+30
-4
zh-cn/application-dev/reference/arkui-ts/ts-methods-textpicker-dialog.md
...on-dev/reference/arkui-ts/ts-methods-textpicker-dialog.md
+1
-1
未找到文件。
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textpicker.md
浏览文件 @
7ad246f6
...
@@ -42,7 +42,7 @@ TextPicker(options?: {range: string[] | [Resource](ts-types.md#resource), select
...
@@ -42,7 +42,7 @@ TextPicker(options?: {range: string[] | [Resource](ts-types.md#resource), select
| 名称 | 描述 |
| 名称 | 描述 |
| ------------------------------------------------------------ | ------------------------------------------------------------ |
| ------------------------------------------------------------ | ------------------------------------------------------------ |
| onChange(callback:
(value:
string,
index:
number)
=
>
void) | 滑动选中TextPicker文本内容后,触发该回调。
<br/>
-
value:
当前选中项的文本。
<br/>
-
index:
当前选中项的
下标
。 |
| onChange(callback:
(value:
string,
index:
number)
=
>
void) | 滑动选中TextPicker文本内容后,触发该回调。
<br/>
-
value:
当前选中项的文本。
<br/>
-
index:
当前选中项的
索引值
。 |
## 示例
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-longpressgesture.md
浏览文件 @
7ad246f6
# LongPressGesture
# LongPressGesture
> **说明:**
> **说明:**
>
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
...
@@ -16,25 +15,21 @@ LongPressGesture(options?: { fingers?: number, repeat?: boolean, duration?: numb
...
@@ -16,25 +15,21 @@ LongPressGesture(options?: { fingers?: number, repeat?: boolean, duration?: numb
**参数:**
**参数:**
| 参数名称 | 参数类型 | 必填 | 默认值 | 参数描述 |
| 参数名称 | 参数类型 | 必填 | 默认值 | 参数描述 |
| -------- | ------- | ---- | ----- | -------------------------------- |
| -------- | -------- | -------- | -------- | -------- |
| fingers | number | 否 | 1 | 触发长按的最少手指数,最小为1指,
最大取值为10指。 |
| fingers | number | 否 | 1 | 触发长按的最少手指数,最小为1指,
最大取值为10指。 |
| repeat | boolean | 否 | false | 是否连续触发事件回调。 |
| repeat | boolean | 否 | false | 是否连续触发事件回调。 |
| duration | number | 否 | 500 | 最小触发长按的时间,单位为毫秒(ms)。 |
| duration | number | 否 | 500 | 触发长按的最短时间,单位为毫秒(ms)。 |
## 事件
## 事件
| 名称 | 功能描述 |
| 名称 | 功能描述 |
| --------
-------------------------------- | ----------------------
-------- |
| --------
|
-------- |
| onAction((event?:
GestureEvent)
=
>
void) | LongPress手势识别成功回调。
|
| onAction((event?:
[GestureEvent](ts-gesture-settings.md))
=
>
void) | LongPress手势识别成功回调。
|
| onActionEnd((event?:
GestureEvent)
=
>
void) | LongPress手势识别成功,手指抬起后触发回调。
|
| onActionEnd((event?:
[GestureEvent](ts-gesture-settings.md))
=
>
void) | LongPress手势识别成功,手指抬起后触发回调。
|
| onActionCancel(event:
()
=
>
void) | LongPress手势识别成功,接收到触摸取消事件触发回调。 |
| onActionCancel(event:
()
=
>
void) | LongPress手势识别成功,接收到触摸取消事件触发回调。 |
## GestureEvent对象中与LongPress手势相关的属性
| 属性名称 | 属性类型 | 描述 |
| ------ | ------- | ------------ |
| repeat | boolean | 事件是否为重复触发事件。 |
## 示例
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pangesture.md
浏览文件 @
7ad246f6
# PanGesture
# PanGesture
> **说明:**
> **说明:**
>
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
...
@@ -16,24 +15,25 @@ PanGesture(options?: { fingers?: number, direction?: PanDirection, distance?: nu
...
@@ -16,24 +15,25 @@ PanGesture(options?: { fingers?: number, direction?: PanDirection, distance?: nu
**参数:**
**参数:**
| 参数名称 | 参数类型 | 必填 | 默认值 | 参数描述
|
| 参数名称 | 参数类型 | 必填 | 默认值 | 参数描述
|
| --------- | ------------ | ---- | ------ | ----------------------------------------------------
-------- |
| -------- | -------- | -------- | -------- |
-------- |
| fingers | number | 否 | 1 | 触发滑动的最少手指数,最小为1指,
最大取值为10指。
|
| fingers | number | 否 | 1 | 触发拖动的最少手指数,最小为1指,
最大取值为10指。
|
| direction | PanDirection | 否 | All | 设置滑动方向,此枚举值支持逻辑与(
&
)和逻辑或(
\|
)运算。
|
| direction | PanDirection | 否 | PanDirection.All | 触发拖动的手势方向,此枚举值支持逻辑与(
&
)和逻辑或(
\|
)运算。
|
| distance | number | 否 | 5.0 | 最小滑
动识别距离,单位为vp。
<br/>
**说明:**
<br/>
> tab滑动与该拖动手势事件同时存在时,可将distance值设为1,使拖动更灵敏,避免造成事件错乱。 |
| distance | number | 否 | 5.0 | 最小拖
动识别距离,单位为vp。
<br/>
**说明:**
<br/>
> tab滑动与该拖动手势事件同时存在时,可将distance值设为1,使拖动更灵敏,避免造成事件错乱。 |
## PanDirection枚举说明
## PanDirection枚举说明
| 名称 | 描述 |
| 名称 | 描述 |
| ---------- | ---------- |
| -------- | -------- |
| All | 所有方向可滑动。 |
| All | 所有方向。 |
| Horizontal | 水平方向可滑动。 |
| Horizontal | 水平方向。 |
| Vertical | 竖直方向可滑动。 |
| Vertical | 竖直方向。 |
| Left | 向左滑动。 |
| Left | 向左拖动。 |
| Right | 向右滑动。 |
| Right | 向右拖动。 |
| Up | 向上滑动。 |
| Up | 向上拖动。 |
| Down | 向下滑动。 |
| Down | 向下拖动。 |
| None | 任何方向都不可滑动。 |
| None | 任何方向都不可触发拖动手势事件。 |
## PanGestureOptions
## PanGestureOptions
...
@@ -43,31 +43,26 @@ PanGestureOptions(options?: { fingers?: number, direction?: PanDirection, distan
...
@@ -43,31 +43,26 @@ PanGestureOptions(options?: { fingers?: number, direction?: PanDirection, distan
**参数:**
**参数:**
同PanGesture参数说明。
同PanGesture参数说明。
**接口:**
**接口:**
| 名称 | 功能描述 |
| 名称 | 功能描述 |
| -------------------------------------- | -------------- |
| -------- | -------- |
| setDirection(value:
PanDirection) | 设置direction属性。 |
| setDirection(value:
PanDirection) | 设置direction属性。 |
| setDistance(value:
number) | 设置distance属性。 |
| setDistance(value:
number) | 设置distance属性。 |
| setFingers(value:
number) | 设置fingers属性。 |
| setFingers(value:
number) | 设置fingers属性。 |
## 事件
## 事件
| 名称 | 功能描述 |
| 名称 | 功能描述 |
| --------
-------------------------------- | ----------------
-------- |
| --------
|
-------- |
| onActionStart(callback:
(event?:
GestureEvent)
=
>
void) | Pan手势识别成功回调。
|
| onActionStart(callback:
(event?:
[GestureEvent](ts-gesture-settings.md))
=
>
void) | Pan手势识别成功回调。
|
| onActionUpdate(callback:
(event?:
GestureEvent)
=
>
void) | Pan手势移动过程中回调。
|
| onActionUpdate(callback:
(event?:
[GestureEvent](ts-gesture-settings.md))
=
>
void) | Pan手势移动过程中回调。
|
| onActionEnd(callback:
(event?:
GestureEvent)
=
>
void) | Pan手势识别成功,手指抬起后触发回调。
|
| onActionEnd(callback:
(event?:
[GestureEvent](ts-gesture-settings.md))
=
>
void) | Pan手势识别成功,手指抬起后触发回调。
|
| onActionCancel(callback:
()
=
>
void) | Pan手势识别成功,接收到触摸取消事件触发回调。 |
| onActionCancel(callback:
()
=
>
void) | Pan手势识别成功,接收到触摸取消事件触发回调。 |
## GestureEvent对象中与Pan手势相关的属性
| 属性名称 | 属性类型 | 描述 |
| ------- | ------ | -------------- |
| offsetX | number | 手势事件偏移量,单位为vp。 |
| offsetY | number | 手势事件偏移量,单位为vp。 |
## 示例
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pinchgesture.md
浏览文件 @
7ad246f6
# PinchGesture
# PinchGesture
> **说明:**
> **说明:**
>
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
...
@@ -16,27 +15,21 @@ PinchGesture(options?: { fingers?: number, distance?: number })
...
@@ -16,27 +15,21 @@ PinchGesture(options?: { fingers?: number, distance?: number })
**参数:**
**参数:**
| 参数名称 | 参数类型 | 必填 | 默认值 | 参数描述 |
| 参数名称 | 参数类型 | 必填 | 默认值 | 参数描述 |
| -------- | ------ | ---- | ---- | ----------------------------- |
| -------- | -------- | -------- | -------- | -------- |
| fingers | number | 否 | 2 | 触发捏合的最少手指数,
最小为2指,最大为5指。 |
| fingers | number | 否 | 2 | 触发捏合的最少手指数,
最小为2指,最大为5指。 |
| distance | number | 否 | 3.0 | 最小识别距离,单位为vp。 |
| distance | number | 否 | 3.0 | 最小识别距离,单位为vp。 |
## 事件
## 事件
| 名称 | 功能描述 |
| 名称 | 功能描述 |
| --------
-------------------------------- | ------------------
-------- |
| --------
|
-------- |
| onActionStart((event?:
GestureEvent)
=
>
void) | Pinch手势识别成功回调。
|
| onActionStart((event?:
[GestureEvent](ts-gesture-settings.md))
=
>
void) | Pinch手势识别成功回调。
|
| onActionUpdate((event?:
GestureEvent)
=
>
void) | Pinch手势移动过程中回调。
|
| onActionUpdate((event?:
[GestureEvent](ts-gesture-settings.md))
=
>
void) | Pinch手势移动过程中回调。
|
| onActionEnd((event?:
GestureEvent)
=
>
void) | Pinch手势识别成功,手指抬起后触发回调。
|
| onActionEnd((event?:
[GestureEvent](ts-gesture-settings.md))
=
>
void) | Pinch手势识别成功,手指抬起后触发回调。
|
| onActionCancel(event:
()
=
>
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
浏览文件 @
7ad246f6
# RotationGesture
# RotationGesture
> **说明:**
> **说明:**
>
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
...
@@ -16,25 +15,21 @@ RotationGesture(options?: { fingers?: number, angle?: number })
...
@@ -16,25 +15,21 @@ RotationGesture(options?: { fingers?: number, angle?: number })
**参数:**
**参数:**
| 参数名称 | 参数类型 | 必填 | 默认值 | 参数描述 |
| 参数名称 | 参数类型 | 必填 | 默认值 | 参数描述 |
| ------- | ------ | ---- | ---- | ----------------------------- |
| -------- | -------- | -------- | -------- | -------- |
| fingers | number | 否 | 2 | 触发旋转的最少手指数,
最小为2指,最大为5指。 |
| fingers | number | 否 | 2 | 触发旋转的最少手指数,
最小为2指,最大为5指。 |
| angle | number | 否 | 1.0 | 触发旋转手势的最小改变度数,单位为度数。 |
| angle | number | 否 | 1.0 | 触发旋转手势的最小改变度数,单位为deg。 |
## 事件
## 事件
| 名称 | 功能描述 |
| 名称 | 功能描述 |
| --------
-------------------------------- | ---------------------
-------- |
| --------
|
-------- |
| onActionStart((event?:
GestureEvent)
=
>
void) | Rotation手势识别成功回调。
|
| onActionStart((event?:
[GestureEvent](ts-gesture-settings.md))
=
>
void) | Rotation手势识别成功回调。
|
| onActionUpdate((event?:
GestureEvent)
=
>
void) | Rotation手势移动过程中回调。
|
| onActionUpdate((event?:
[GestureEvent](ts-gesture-settings.md))
=
>
void) | Rotation手势移动过程中回调。
|
| onActionEnd((event?:
GestureEvent)
=
>
void) | Rotation手势识别成功,手指抬起后触发回调。
|
| onActionEnd((event?:
[GestureEvent](ts-gesture-settings.md))
=
>
void) | Rotation手势识别成功,手指抬起后触发回调。
|
| onActionCancel(event:
()
=
>
void) | Rotation手势识别成功,接收到触摸取消事件触发回调。 |
| onActionCancel(event:
()
=
>
void) | Rotation手势识别成功,接收到触摸取消事件触发回调。 |
## GestureEvent对象中与Rotation手势相关的属性
| 属性名称 | 属性类型 | 描述 |
| ----- | ------ | ----- |
| angle | number | 旋转角度。 |
## 示例
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-swipegesture.md
浏览文件 @
7ad246f6
# SwipeGesture
# SwipeGesture
> **说明:**
> **说明:**
>
> 从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
> 从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
...
@@ -16,32 +15,28 @@ SwipeGesture(value?: { fingers?: number; direction?: SwipeDirection; speed?: num
...
@@ -16,32 +15,28 @@ SwipeGesture(value?: { fingers?: number; direction?: SwipeDirection; speed?: num
**参数:**
**参数:**
| 参数名称 | 参数类型 | 必填 | 默认值 | 参数描述
|
| 参数名称 | 参数类型 | 必填 | 默认值 | 参数描述
|
| --------- | -------------- | ---- | ------------------ | ---------------------
-------- |
| -------- | -------- | -------- | -------- |
-------- |
| fingers | number | 否 | 1
| 触发滑动的最少手指数,默认为1,最小为1指,最大为10指。 |
| fingers | number | 否 | 1
| 触发滑动的最少手指数,默认为1,最小为1指,最大为10指。 |
| direction | SwipeDirection | 否 | SwipeDirection.All | 滑动方向。
|
| direction | SwipeDirection | 否 | SwipeDirection.All | 触发滑动手势的滑动方向。
|
| speed | number | 否 | 100 | 识别滑动的最小速度(100VP/秒)。
|
| speed | number | 否 | 100 | 识别滑动的最小速度(默认为100vp/秒)。
|
## SwipeDirection枚举说明
## SwipeDirection枚举说明
| 名称 | 描述 |
| 名称 | 描述 |
| ---------- | ----- |
| -------- | -------- |
| All | 所有方向。 |
| All | 所有方向。 |
| Horizontal | 水平方向。 |
| Horizontal | 水平方向。 |
| Vertical | 竖直方向。 |
| Vertical | 竖直方向。 |
| None | 任何方向均不可触发。 |
## 事件
## 事件
| 名称 | 功能描述 |
| 名称 | 功能描述 |
| ---------------------------------------- | ----------- |
| -------- | -------- |
| onAction(callback:(event?:
GestureEvent)
=
>
void) | 滑动手势识别成功回调。 |
| onAction(callback:(event?:
[GestureEvent](ts-gesture-settings.md))
=
>
void) | 滑动手势识别成功回调。 |
## GestureEvent对象中与Swipe手势相关的属性
| 参数名 | 类型 | 说明 |
| ----- | ------ | ---------------------------------------- |
| angle | number | 滑动手势的角度,即两根手指间的线段与水平方向的夹角变化的度数。
<br/>
>
**说明:**
<br/>
>
角度计算方式:滑动手势被识别到后,连接两根手指之间的线被识别为起始线条,随着手指的滑动,手指之间的线条会发生旋转,根据起始线条两端点和当前线条两端点的坐标,使用反正切函数分别计算其相对于水平方向的夹角,最后arctan2(cy2-cy1,cx2-cx1)-arctan2(y2-y1,x2-x1)为旋转的角度。以起始线条为坐标系,顺时针旋转为0到180度,逆时针旋转为-180到0度。 |
| speed | number | 滑动手势的速度,是所有手指滑动的平均速度,单位为VP/秒。 |


## 示例
## 示例
...
@@ -64,7 +59,7 @@ struct SwipeGestureExample {
...
@@ -64,7 +59,7 @@ struct SwipeGestureExample {
.
width
(
260
).
height
(
260
)
.
width
(
260
).
height
(
260
)
.
rotate
({
x
:
0
,
y
:
0
,
z
:
1
,
angle
:
this
.
rotateAngle
})
.
rotate
({
x
:
0
,
y
:
0
,
z
:
1
,
angle
:
this
.
rotateAngle
})
.
gesture
(
.
gesture
(
SwipeGesture
({
fingers
:
1
,
direction
:
SwipeDirection
.
Vertical
})
SwipeGesture
({
fingers
:
1
,
direction
:
SwipeDirection
.
Vertical
})
.
onAction
((
event
:
GestureEvent
)
=>
{
.
onAction
((
event
:
GestureEvent
)
=>
{
this
.
speed
=
event
.
speed
this
.
speed
=
event
.
speed
this
.
rotateAngle
=
event
.
angle
this
.
rotateAngle
=
event
.
angle
...
...
zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-tapgesture.md
浏览文件 @
7ad246f6
# TapGesture
# TapGesture
> **说明:**
> **说明:**
>
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
...
@@ -16,15 +15,16 @@ TapGesture(options?: { count?: number, fingers?: number })
...
@@ -16,15 +15,16 @@ TapGesture(options?: { count?: number, fingers?: number })
**参数:**
**参数:**
| 参数名称 | 参数类型 | 必填 | 默认值 | 参数描述 |
| 参数名称 | 参数类型 | 必填 | 默认值 | 参数描述 |
| ------- | ------ | ---- | ---- | ---------------------------------------- |
| -------- | -------- | -------- | -------- | -------- |
| count | number | 否 | 1 | 识别的连续点击次数。如果设置小于1,会被转化为默认值。
<br/>
>
**说明:**
<br/>
>
如配置多击,上一次抬起和下一次按下的超时时间为300毫秒(ms)。 |
| count | number | 否 | 1 | 识别的连续点击次数。如果设置小于1,会被转化为默认值。
<br/>
>
**说明:**
<br/>
>
如配置多击,上一次抬起和下一次按下的超时时间为300毫秒(ms)。 |
| fingers | number | 否 | 1 | 触发点击的最少手指数,最小为1指,
最大为10指。
<br/>
>
**说明:**
<br/>
>
1.
当配置多指时,第一根手指按下后300毫秒(ms)内未有足够的手指数按下,手势识别失败。
<br/>
>
<br/>
>
2.
实际点击手指数超过配置值,手势识别失败。 |
| fingers | number | 否 | 1 | 触发点击的最少手指数,最小为1指,
最大为10指。
<br/>
>
**说明:**
<br/>
>
1.
当配置多指时,第一根手指按下后300毫秒(ms)内未有足够的手指数按下,手势识别失败。
<br/>
>
2.
实际点击手指数超过配置值,手势识别失败。 |
## 事件
## 事件
| 名称 | 功能描述 |
| 名称 | 功能描述 |
| --------
-------------------------------- | ----
-------- |
| --------
|
-------- |
| onAction((event?:
[GestureEvent](ts-gesture-settings.md))
=
>
void) | Tap手势识别成功回调。 |
| onAction((event?:
[GestureEvent](ts-gesture-settings.md))
=
>
void) | Tap手势识别成功回调。 |
...
...
zh-cn/application-dev/reference/arkui-ts/ts-gesture-settings.md
浏览文件 @
7ad246f6
...
@@ -43,7 +43,7 @@
...
@@ -43,7 +43,7 @@
## 响应手势事件
## 响应手势事件
组件通过gesture方法绑定手势对象,可以通过手势对象提供的事件相应响应手势操作。
如通过TapGesture对象的onAction事件响应点击事件。具体
事件定义见各个手势对象章节。
组件通过gesture方法绑定手势对象,可以通过手势对象提供的事件相应响应手势操作。
例如通过TapGesture对象的onAction事件响应点击事件。其余手势的
事件定义见各个手势对象章节。
-
TapGesture事件说明
-
TapGesture事件说明
| 名称 | 功能描述 |
| 名称 | 功能描述 |
...
@@ -51,10 +51,36 @@
...
@@ -51,10 +51,36 @@
| onAction((event?:GestureEvent)
=
>
void) | Tap手势识别成功回调。 |
| onAction((event?:GestureEvent)
=
>
void) | Tap手势识别成功回调。 |
-
GestureEvent对象说明
-
GestureEvent对象说明
|
属性名称 | 属性
类型 | 描述 |
|
名称 |
类型 | 描述 |
| -------- | -------- | -------- |
| -------- | -------- | -------- |
| timestamp | number | 事件时间戳。 |
| timestamp
<sup>
8+
</sup>
| number | 事件时间戳。 |
| target
<sup>
8+
</sup>
|
[
EventTarget
](
ts-universal-events-click.md
)
| 触发手势事件的元素对象。 |
| 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/>
>
**说明:**
<br/>
>
角度计算方式:滑动手势被识别到后,连接两根手指之间的线被识别为起始线条,随着手指的滑动,手指之间的线条会发生旋转,根据起始线条两端点和当前线条两端点的坐标,使用反正切函数分别计算其相对于水平方向的夹角,最后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
浏览文件 @
7ad246f6
...
@@ -21,7 +21,7 @@ show(options: TextPickerDialogOptions)
...
@@ -21,7 +21,7 @@ show(options: TextPickerDialogOptions)
| range | string[] | 是 | - | 选择器的数据选择范围。 |
| range | string[] | 是 | - | 选择器的数据选择范围。 |
| selected | number | 否 | 0 | 选中项在数组中的index值。 |
| selected | number | 否 | 0 | 选中项在数组中的index值。 |
| value | string | 否 | 第一个元素值 | 选中项的值,优先级低于selected。 |
| value | string | 否 | 第一个元素值 | 选中项的值,优先级低于selected。 |
| defaultPickerItemHeight | number | 否 | - | 默认Picker内容项元素高度。 |
| defaultPickerItemHeight | number
\|
string
| 否 | - | 默认Picker内容项元素高度。 |
| onAccept | (value: TextPickerResult) => void | 否 | - | 点击弹窗中确定按钮时触发。 |
| onAccept | (value: TextPickerResult) => void | 否 | - | 点击弹窗中确定按钮时触发。 |
| onCancel | () => void | 否 | - | 点击弹窗中取消按钮时触发。 |
| onCancel | () => void | 否 | - | 点击弹窗中取消按钮时触发。 |
| onChange | (value: TextPickerResult) => void | 否 | - | 滑动选择器,当前选择项改变时触发。 |
| onChange | (value: TextPickerResult) => void | 否 | - | 滑动选择器,当前选择项改变时触发。 |
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录