diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-media-components-video.md b/zh-cn/application-dev/reference/arkui-ts/ts-media-components-video.md index 7cc4310938bb074636f2b190eb20acf059073d8f..0d30acaf2794c432ae1d152b0303c2b059effa45 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-media-components-video.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-media-components-video.md @@ -1,7 +1,7 @@ # Video > **说明：** -> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 +> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 视频播放组件。 @@ -13,7 +13,7 @@ "abilities":[ { ... - "permissions": ["ohos.permission.INTERNET], + "permissions": ["ohos.permission.INTERNET"], ... } ] @@ -30,47 +30,47 @@ Video(value: VideoOptions) - VideoOptions类型接口说明 - | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | - | -------- | -------- | -------- | -------- | -------- | - | src | string \| [Resource](../../ui/ts-types.md) | 否 | - | 视频播放源的路径，支持本地视频路径和网络路径。
支持在resources下面的video或rawfile文件夹里放置媒体资源。
支持dataability://的路径前缀，用于访问通过Data Ability提供的视频路径，具体路径信息详见[Data Ability说明](../../ability/fa-dataability.md)。 | - | currentProgressRate | number \| PlaybackSpeed8+ | 否 | 1.0 \| PlaybackSpeed.
Speed_Forward_1_00_X | 视频播放倍速。
>  **说明：**
> number取值仅支持：0.75，1.0，1.25，1.75，2.0。
| - | previewUri | string \| PixelMap8+ \| [Resource](../../ui/ts-types.md) | 否 | - | 预览图片的路径。 | - | controller | [VideoController](#videocontroller) | 否 | - | 控制器。 | + | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | + | ------------------- | ---------------------------------------- | ---- | ---------------------------------------- | ---------------------------------------- | + | src | string \| [Resource](../../ui/ts-types.md) | 否 | - | 视频播放源的路径，支持本地视频路径和网络路径。
支持在resources下面的video或rawfile文件夹里放置媒体资源。
支持dataability://的路径前缀，用于访问通过Data Ability提供的视频路径，具体路径信息详见[Data Ability说明](../../ability/fa-dataability.md)。 | + | currentProgressRate | number \| PlaybackSpeed8+ | 否 | 1.0 \| PlaybackSpeed.
Speed_Forward_1_00_X | 视频播放倍速。
>  **说明：**
> number取值仅支持：0.75，1.0，1.25，1.75，2.0。
| + | previewUri | string \| PixelMap8+ \| [Resource](../../ui/ts-types.md) | 否 | - | 预览图片的路径。 | + | controller | [VideoController](#videocontroller) | 否 | - | 控制器。 | - PlaybackSpeed8+类型接口说明 - | 名称 | 描述 | - | -------- | -------- | + | 名称 | 描述 | + | -------------------- | --------- | | Speed_Forward_0_75_X | 0.75倍速播放。 | - | Speed_Forward_1_00_X | 1倍速播放。 | + | Speed_Forward_1_00_X | 1倍速播放。 | | Speed_Forward_1_25_X | 1.25倍速播放。 | | Speed_Forward_1_75_X | 1.75倍速播放。 | - | Speed_Forward_2_00_X | 2倍速播放。 | + | Speed_Forward_2_00_X | 2倍速播放。 | ## 属性 -| 名称 | 参数类型 | 默认值 | 描述 | -| -------- | -------- | -------- | -------- | -| muted | boolean | false | 是否静音。 | -| autoPlay | boolean | false | 是否自动播放。 | -| controls | boolean | true | 控制视频播放的控制栏是否显示。 | -| objectFit | [ImageFit](ts-basic-components-image.md) | Cover | 设置视频显示模式。 | -| loop | boolean | false | 是否单个视频循环播放。 | +| 名称 | 参数类型 | 默认值 | 描述 | +| --------- | ---------------------------------------- | ----- | --------------- | +| muted | boolean | false | 是否静音。 | +| autoPlay | boolean | false | 是否自动播放。 | +| controls | boolean | true | 控制视频播放的控制栏是否显示。 | +| objectFit | [ImageFit](ts-basic-components-image.md) | Cover | 设置视频显示模式。 | +| loop | boolean | false | 是否单个视频循环播放。 | ## 事件 -| 名称 | 功能描述 | -| -------- | -------- | -| onStart() => void | 播放时触发该事件。 | -| onPause() => void | 暂停时触发该事件。 | -| onFinish() => void | 播放结束时触发该事件。 | -| onError() => void | 播放失败时触发该事件。 | +| 名称 | 功能描述 | +| ---------------------------------------- | ---------------------------------------- | +| onStart() => void | 播放时触发该事件。 | +| onPause() => void | 暂停时触发该事件。 | +| onFinish() => void | 播放结束时触发该事件。 | +| onError() => void | 播放失败时触发该事件。 | | onPrepared(event?: { duration: number }) => void | 视频准备完成时触发该事件，通过duration可以获取视频时长，单位为秒(s)。 | -| onSeeking(event?: { time: number }) => void | 操作进度条过程时上报时间信息，单位为s。 | -| onSeeked(event?: { time: number }) => void | 操作进度条完成后，上报播放时间信息，单位为s。 | -| onUpdate(event?: { time: number }) => void | 播放进度变化时触发该事件，单位为s，更新时间间隔为250ms。 | +| onSeeking(event?: { time: number }) => void | 操作进度条过程时上报时间信息，单位为s。 | +| onSeeked(event?: { time: number }) => void | 操作进度条完成后，上报播放时间信息，单位为s。 | +| onUpdate(event?: { time: number }) => void | 播放进度变化时触发该事件，单位为s，更新时间间隔为250ms。 | ## VideoController @@ -110,9 +110,9 @@ setCurrentTime(value: number) 指定视频播放的进度位置。 - 参数 - | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | - | -------- | -------- | -------- | -------- | -------- | - | value | number | 是 | - | 视频播放进度位置。 | + | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | + | ----- | ------ | ---- | ---- | --------- | + | value | number | 是 | - | 视频播放进度位置。 | ### requestFullscreen @@ -121,9 +121,9 @@ requestFullscreen(value: boolean) 请求全屏播放。 - 参数 - | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | - | -------- | -------- | -------- | -------- | -------- | - | value | number | 是 | false | 是否全屏播放。 | + | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | + | ----- | ------ | ---- | ----- | ------- | + | value | number | 是 | false | 是否全屏播放。 | ### exitFullscreen @@ -138,18 +138,18 @@ setCurrentTime(value: number, seekMode: SeekMode) 指定视频播放的进度位置，并指定跳转模式。 - 参数 - | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | - | -------- | -------- | -------- | -------- | -------- | - | value | number | 是 | - | 视频播放进度位置。 | - | seekMode | SeekMode | 是 | - | 跳转模式。 | + | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | + | -------- | -------- | ---- | ---- | --------- | + | value | number | 是 | - | 视频播放进度位置。 | + | seekMode | SeekMode | 是 | - | 跳转模式。 | - SeekMode8+类型接口说明 - | 名称 | 描述 | - | -------- | -------- | - | PreviousKeyframe | 跳转到前一个最近的关键帧。 | - | NextKeyframe | 跳转到后一个最近的关键帧。 | - | ClosestKeyframe | 跳转到最近的关键帧。 | - | Accurate | 精准跳转，不论是否为关键帧。 | + | 名称 | 描述 | + | ---------------- | -------------- | + | PreviousKeyframe | 跳转到前一个最近的关键帧。 | + | NextKeyframe | 跳转到后一个最近的关键帧。 | + | ClosestKeyframe | 跳转到最近的关键帧。 | + | Accurate | 精准跳转，不论是否为关键帧。 | diff --git 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 index b6f7555d1ee6e94474a0561b6dcbab1f9865dba6..7af69a3a8a104b380acb928c8cddd3783e90e078 100644 --- 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 @@ -1,7 +1,7 @@ # 点击事件 > **说明：** -> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 +> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 ## 权限列表 @@ -11,38 +11,38 @@ ## 事件 -| 名称 | 支持冒泡 | 功能描述 | -| -------- | -------- | -------- | -| onClick(callback: (event?: ClickEvent) => void) | 否 | 点击动作触发该方法调用，event参数见ClickEvent介绍。 | - -### ClickEvent对象说明 - | 属性名称 | 类型 | 描述 | - | -------- | -------- | -------- | - | screenX | number | 点击点相对于设备屏幕左边沿的X坐标。 | - | screenY | number | 点击点相对于设备屏幕上边沿的Y坐标。 | - | x | number | 点击点相对于被点击元素左边沿的X坐标。 | - | y | number | 点击点相对于被点击元素上边沿的Y坐标。 | - | target8+ | EventTarget | 被点击元素对象。 | - | timestamp | number | 事件时间戳。 | - -- EventTarget8+对象说明 - | 名称 | 参数类型 | 描述 | - | -------- | -------- | -------- | - | area | Area | 目标元素的区域信息。 | - -- Area8+对象说明 - | 属性名称 | 类型 | 描述 | - | -------- | -------- | -------- | - | width | number | 目标元素的宽度，单位为vp。 | - | height | number | 目标元素的高度，单位为vp。 | - | position | Position | 目标元素左上角相对父元素左上角的位置。 | - | globalPosition | Position | 目标元素左上角相对页面左上角的位置。 | - -- Position8+对象说明 - | 属性名称 | 参数类型 | 描述 | - | -------- | -------- | -------- | - | x | number | x轴坐标，单位为vp。 | - | y | number | y轴坐标，单位为vp。 | +| 名称 | 支持冒泡 | 功能描述 | +| ---------------------------------------- | ---- | --------------------------------- | +| onClick(callback: (event?: ClickEvent) => void) | 否 | 点击动作触发该方法调用，event参数见ClickEvent介绍。 | + +## ClickEvent对象说明 +| 属性名称 | 类型 | 描述 | +| ------------------- | -------------------------------- | ------------------- | +| screenX | number | 点击点相对于设备屏幕左边沿的X坐标。 | +| screenY | number | 点击点相对于设备屏幕上边沿的Y坐标。 | +| x | number | 点击点相对于被点击元素左边沿的X坐标。 | +| y | number | 点击点相对于被点击元素上边沿的Y坐标。 | +| target8+ | [EventTarget](#eventtarget8对象说明) | 被点击元素对象。 | +| timestamp | number | 事件时间戳。 | + +## EventTarget8+对象说明 +| 名称 | 参数类型 | 描述 | +| ---- | ----------------- | ---------- | +| area | [Area](Area8对象说明) | 目标元素的区域信息。 | + +## Area8+对象说明 +| 属性名称 | 类型 | 描述 | +| -------------- | -------------------------- | ------------------- | +| width | number | 目标元素的宽度，单位为vp。 | +| height | number | 目标元素的高度，单位为vp。 | +| position | [Position](#position8对象说明) | 目标元素左上角相对父元素左上角的位置。 | +| globalPosition | [Position](#position8对象说明) | 目标元素左上角相对页面左上角的位置。 | + +## Position8+对象说明 +| 属性名称 | 参数类型 | 描述 | +| ---- | ------ | ----------- | +| x | number | x轴坐标，单位为vp。 | +| y | number | y轴坐标，单位为vp。 | ## 示例 diff --git 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 index 55f546683c3b7bde9a5563e7af9a5139f1ba0efc..154a2c0ec7e4f6aca9c77fe86987e1394cb718a7 100644 --- 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 @@ -1,33 +1,31 @@ # 拖拽事件 > **说明：** -> 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 +> 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 ## 事件 -| 名称 | 支持冒泡 | 功能描述 | -| -------- | -------- | -------- | -| onDragStart(callback: (event: DragEvent, extraParams?: string) =>  [CustomBuilder](../../ui/ts-types.md)) | 否 | 第一次拖拽此事件绑定的组件时，触发回调。
event：拖拽事件信息，包括拖拽点坐标。
extraParams：拖拽事件额外信息，详见extraParam类型描述。
返回值：当前跟手效果所拖拽的对象，用于显示拖拽时的提示组件。
>  **说明：**
> - 长按150毫秒(ms)可触发拖拽事件。
> - 优先级：长按手势配置时间小于等于150毫秒(ms)时，长按手势优先触发，否则拖拽事件优先触发。 | -| onDragEnter(callback: (event: DragEvent, extraParams?: string) => void) | 否 | 拖拽进入组件范围内时，触发回调。
event：拖拽事件信息，包括拖拽点坐标。
extraParams：拖拽事件额外信息，详见extraParam类型描述。
>  **说明：**
> 当监听了onDrop事件时，此事件才有效。 | -| onDragMove(callback: (event: DragEvent, extraParams?: string) => void) | 否 | 拖拽在组件范围内移动时，触发回调。
event：拖拽事件信息，包括拖拽点坐标。
extraParams：拖拽事件额外信息，详见extraParam类型描述。
>  **说明：**
> 当监听了onDrop事件时，此事件才有效。 | -| onDragLeave(callback: (event: DragEvent, extraParams?: string) => void) | 否 | 拖拽离开组件范围内时，触发回调。
event：拖拽事件信息，包括拖拽点坐标。
extraParams：拖拽事件额外信息，详见extraParam类型描述。
>  **说明：**
> 当监听了onDrop事件时，此事件才有效。 | -| onDrop(callback: (event: DragEvent, extraParams?: string) => void) | 否 | 绑定此事件的组件可作为拖拽释放目标，当在本组件范围内停止拖拽行为时，触发回调。
event：拖拽事件信息，包括拖拽点坐标。
extraParams：拖拽事件额外信息，详见extraParam类型描述。 | +| 名称 | 支持冒泡 | 功能描述 | +| ---------------------------------------- | ---- | ---------------------------------------- | +| onDragStart(callback: (event: DragEvent, extraParams?: string) =>  [CustomBuilder](../../ui/ts-types.md)) | 否 | 第一次拖拽此事件绑定的组件时，触发回调。
- event：拖拽事件信息，包括拖拽点坐标。
- extraParams：拖拽事件额外信息，详见extraParam类型描述。
返回值：当前跟手效果所拖拽的对象，用于显示拖拽时的提示组件。
长按150毫秒(ms)可触发拖拽事件。优先级：长按手势配置时间小于等于150毫秒(ms)时，长按手势优先触发，否则拖拽事件优先触发。 | +| onDragEnter(callback: (event: DragEvent, extraParams?: string) => void) | 否 | 拖拽进入组件范围内时，触发回调。
- event：拖拽事件信息，包括拖拽点坐标。
- extraParams：拖拽事件额外信息，详见extraParam类型描述。
当监听了onDrop事件时，此事件才有效。 | +| onDragMove(callback: (event: DragEvent, extraParams?: string) => void) | 否 | 拖拽在组件范围内移动时，触发回调。
- event：拖拽事件信息，包括拖拽点坐标。
- extraParams：拖拽事件额外信息，详见extraParam类型描述。
当监听了onDrop事件时，此事件才有效。 | +| onDragLeave(callback: (event: DragEvent, extraParams?: string) => void) | 否 | 拖拽离开组件范围内时，触发回调。
- event：拖拽事件信息，包括拖拽点坐标。
- extraParams：拖拽事件额外信息，详见extraParam类型描述。
当监听了onDrop事件时，此事件才有效。 | +| onDrop(callback: (event: DragEvent, extraParams?: string) => void) | 否 | 绑定此事件的组件可作为拖拽释放目标，当在本组件范围内停止拖拽行为时，触发回调。
- event：拖拽事件信息，包括拖拽点坐标。
- extraParams：拖拽事件额外信息，详见extraParam类型描述。 | - extraParam说明
用于返回组件在拖拽中需要用到的额外信息。 extraParam是Json对象转换的string字符串，可以通过Json.parse转换的Json对象获取如下属性。 - | 属性名称 | 属性类型 | 描述 | - | -------- | -------- | -------- | - | selectedIndex | number | 当拖拽事件设在父容器的子元素时，selectedIndex表示当前被拖拽子元素是父容器第selectedIndex个子元素，selectedIndex从0开始。
>  **说明：**
> 仅在ListItem组件中生效。 | - | insertIndex | number | 当前拖拽元素在List组件中放下时，insertIndex表示被拖拽元素插入该组件的第insertIndex个位置，insertIndex从0开始。
>  **说明：**
> 仅在List组件的拖拽事件中生效。 | + | 属性名称 | 属性类型 | 描述 | + | ------------- | ------ | ---------------------------------------- | + | selectedIndex | number | 当拖拽事件设在父容器的子元素时，selectedIndex表示当前被拖拽子元素是父容器第selectedIndex个子元素，selectedIndex从0开始。
仅在ListItem组件中生效。 | + | insertIndex | number | 当前拖拽元素在List组件中放下时，insertIndex表示被拖拽元素插入该组件的第insertIndex个位置，insertIndex从0开始。
仅在List组件的拖拽事件中生效。 | ### DragEvent对象说明 -- 接口 - | 名称 | 返回值类型 | 功能描述 | - | -------- | -------- | -------- | - | getX() | number | 当前拖拽点x轴坐标，单位为vp。 | - | getY() | number | 当前拖拽点y轴坐标，单位为vp。 | - +| 名称 | 返回值类型 | 功能描述 | +| ------ | ------ | ---------------- | +| getX() | number | 当前拖拽点x轴坐标，单位为vp。 | +| getY() | number | 当前拖拽点y轴坐标，单位为vp。 | ## 示例 diff --git 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 index b66378435fca21af310851df529b1d5233c8ad35..c395fff5bf5063607a475181f74d380729a951c0 100644 --- 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 @@ -1,7 +1,7 @@ # 按键事件 > **说明：** -> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 +> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 ## 权限列表 @@ -11,53 +11,53 @@ ## 事件 -| 名称 | 支持冒泡 | 功能描述 | -| -------- | -------- | -------- | -| onKeyEvent(event: (event?: KeyEvent) => void) | 是 | 按键动作触发该方法调用，event参数见[KeyEvent](#keyevent对象说明)介绍。 | +| 名称 | 支持冒泡 | 功能描述 | +| ---------------------------------------- | ---- | ---------------------------------------- | +| onKeyEvent(event: (event?: KeyEvent) => 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(): void | 阻塞事件冒泡传递。 | - -- KeyType枚举说明 - | 名称 | 描述 | - | -------- | -------- | - | Down | 按键按下。 | - | Up | 按键松开。 | - - -- KeySource枚举说明 - | 名称 | 描述 | - | -------- | -------- | - | Unknown | 输入设备类型未知。 | - | Keyboard | 输入设备类型为键盘。 | - -- 常用KeyCode说明 - | 数值 | 行为 | 物理按键 | - | -------- | -------- | -------- | - | 19 | 上 | 向上方向键。 | - | 20 | 下 | 向下方向键。 | - | 21 | 左 | 向左方向键。 | - | 22 | 右 | 向右方向键。 | - | 23 | 确定 | 遥控器的确认键。 | - | 66 | 确定 | 键盘的回车键。 | - | 160 | 确定 | 键盘的小键盘回车键。 | + | 接口名称 | 功能描述 | + | ---------------------------- | --------- | + | stopPropagation(): void | 阻塞事件冒泡传递。 | + +## KeyType枚举说明 +| 名称 | 描述 | +| ---- | ----- | +| Down | 按键按下。 | +| Up | 按键松开。 | + + +## KeySource枚举说明 +| 名称 | 描述 | +| ----------------------- | ---------- | +| Unknown | 输入设备类型未知。 | +| [KeyCode](#常用keycode说明) | 输入设备类型为键盘。 | + +## 常用KeyCode说明 +| 数值 | 行为 | 物理按键 | +| ---- | ---- | ---------- | +| 19 | 上 | 向上方向键。 | +| 20 | 下 | 向下方向键。 | +| 21 | 左 | 向左方向键。 | +| 22 | 右 | 向右方向键。 | +| 23 | 确定 | 遥控器的确认键。 | +| 66 | 确定 | 键盘的回车键。 | +| 160 | 确定 | 键盘的小键盘回车键。 | ## 示例 diff --git 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 index 8285447b7bf50b4d408b2d3c4c17b6dc362f2380..60a3e399ace731955a2e3f8b6ba1189f98e07885 100644 --- 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 @@ -16,14 +16,14 @@ | onTouch(callback: (event?: TouchEvent) => void) | 是 | 触摸动作触发该方法调用，event参数见[TouchEvent](#touchevent对象说明)介绍。 | -### TouchEvent对象说明 +## TouchEvent对象说明 - 属性 | 属性名称 | 类型 | 描述 | | ------------------- | ---------------------------------------- | ------------ | | type | TouchType | 触摸事件的类型。 | - | touches | ArrayTouchObject> | 全部手指信息。 | - | changedTouches | ArrayTouchObject> | 当前发生变化的手指信息。 | + | touches | Array<[TouchObject](touchobject对象说明)> | 全部手指信息。 | + | changedTouches | Array<[TouchObject](touchobject对象说明)> | 当前发生变化的手指信息。 | | timestamp | number | 事件时间戳。 | | target8+ | [EventTarget](ts-universal-events-click.md) | 被触摸元素对象。 | @@ -34,24 +34,24 @@ | stopPropagation()：void | 阻塞事件冒泡。 | -- TouchObject对象说明 - | 属性名称 | 类型 | 描述 | - | ------- | --------- | ------------------- | - | type | TouchType | 触摸事件的类型。 | - | id | number | 手指唯一标识符。 | - | screenX | number | 触摸点相对于设备屏幕左边沿的X坐标。 | - | screenY | number | 触摸点相对于设备屏幕上边沿的Y坐标。 | - | x | number | 触摸点相对于被触摸元素左边沿的X坐标。 | - | y | number | 触摸点相对于被触摸元素上边沿的Y坐标。 | - - -- TouchType枚举说明 - | 名称 | 描述 | - | ------ | --------------- | - | Down | 手指按下时触发。 | - | Up | 手指抬起时触发。 | - | Move | 手指按压态在屏幕上移动时触发。 | - | Cancel | 触摸事件取消时触发。 | +## TouchObject对象说明 +| 属性名称 | 类型 | 描述 | +| ------- | --------------------------- | ------------------- | +| type | [TouchType](#touchtype枚举说明) | 触摸事件的类型。 | +| id | number | 手指唯一标识符。 | +| screenX | number | 触摸点相对于设备屏幕左边沿的X坐标。 | +| screenY | number | 触摸点相对于设备屏幕上边沿的Y坐标。 | +| x | number | 触摸点相对于被触摸元素左边沿的X坐标。 | +| y | number | 触摸点相对于被触摸元素上边沿的Y坐标。 | + + +## TouchType枚举说明 +| 名称 | 描述 | +| ------ | --------------- | +| Down | 手指按下时触发。 | +| Up | 手指抬起时触发。 | +| Move | 手指按压态在屏幕上移动时触发。 | +| Cancel | 触摸事件取消时触发。 | ## 示例 diff --git 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 index f1defe84da34297a09e0ac5a8003d3d023f45b39..febe01ccc186e38bb1bebc8a0f1b9524b54227ef 100644 --- 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 @@ -1,7 +1,7 @@ # 鼠标事件 > **说明：** -> 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 +> 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 ## 权限列表 @@ -11,40 +11,40 @@ ## 事件 -| 名称 | 支持冒泡 | 描述 | -| -------- | -------- | -------- | -| onHover(callback: (isHover: boolean) => void) | 否 | 鼠标进入或退出组件时触发该回调。
isHover：表示鼠标是否悬浮在组件上，鼠标进入时为true, 退出时为false。 | -| onMouse(callback: (event?: MouseEvent) => 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: (isHover: boolean) => void) | 否 | 鼠标进入或退出组件时触发该回调。
isHover：表示鼠标是否悬浮在组件上，鼠标进入时为true, 退出时为false。 | +| onMouse(callback: (event?: MouseEvent) => 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 | 鼠标移动。 | ## 示例 diff --git a/zh-cn/application-dev/task-management/Readme-CN.md b/zh-cn/application-dev/task-management/Readme-CN.md index bcdf589e64cfeb12e231abf010cf12dd4071e182..4fa19ff234a346a8746ea99df6a6684bbce621de 100644 --- a/zh-cn/application-dev/task-management/Readme-CN.md +++ b/zh-cn/application-dev/task-management/Readme-CN.md @@ -7,5 +7,5 @@ 延迟任务调度 -- [延迟任务调度概述](work-scheduler-overview.md) -- [延迟任务调度开发指导](work-scheduler-dev-guide.md) \ No newline at end of file + - [延迟任务调度概述](work-scheduler-overview.md) + - [延迟任务调度开发指导](work-scheduler-dev-guide.md) \ No newline at end of file