diff --git a/zh-cn/application-dev/Readme-CN.md b/zh-cn/application-dev/Readme-CN.md index 58ab64517e51a30286c6cdad60bd1b30ff3c081d..9ceb28dd690c792e9109b3a924f7e2c7a971fef8 100644 --- a/zh-cn/application-dev/Readme-CN.md +++ b/zh-cn/application-dev/Readme-CN.md @@ -29,8 +29,7 @@ - [数据管理](database/Readme-CN.md) - [电话服务](telephony/Readme-CN.md) - [后台代理提醒](background-agent-scheduled-reminder/Readme-CN.md) - - [后台任务管理](background-task-management/Readme-CN.md) - - [延迟任务调度](work-scheduler/Readme-CN.md) + - [任务管理](task-management/Readme-CN.md) - [设备管理](device/Readme-CN.md) - [设备使用信息统计](device-usage-statistics/Readme-CN.md) - [DFX](dfx/Readme-CN.md) diff --git a/zh-cn/application-dev/application-dev-guide-for-gitee.md b/zh-cn/application-dev/application-dev-guide-for-gitee.md index d17125d0aeed1038481a0a74e36ebc4d270decfe..1c2a1702cae937a57beac48f1d0dc39ddde6e59d 100644 --- a/zh-cn/application-dev/application-dev-guide-for-gitee.md +++ b/zh-cn/application-dev/application-dev-guide-for-gitee.md @@ -31,7 +31,7 @@ - [网络与连接](connectivity/Readme-CN.md) - [数据管理](database/Readme-CN.md) - [后台代理提醒](background-agent-scheduled-reminder/Readme-CN.md) -- [后台任务管理](background-task-management/Readme-CN.md) +- [任务管理](task-management/Readme-CN.md) - [设备管理](device/Readme-CN.md) - [设备使用信息统计](device-usage-statistics/Readme-CN.md) - [DFX](dfx/Readme-CN.md) @@ -53,9 +53,9 @@ API参考提供了OpenHarmony全量组件和接口的参考文档，可以帮助 内容包括： - [组件参考（基于JS扩展的类Web开发范式）](reference/arkui-js/Readme-CN.md) - [组件参考（基于TS扩展的声明式开发范式）](reference/arkui-ts/Readme-CN.md) -- 接口参考 +- 接口参考 - [JS及TS API参考](reference/apis/Readme-CN.md) - - Native API + - Native API - [Native API参考](reference/native-apis/Readme-CN.md) - [标准库](reference/native-lib/third_party_libc/musl.md) - [Node_API](reference/native-lib/third_party_napi/napi.md) diff --git a/zh-cn/application-dev/application-dev-guide.md b/zh-cn/application-dev/application-dev-guide.md index d4458e3c14bd3402c70c1203b8e8b9feec5016db..8a87bcd372e32c8c68a292622783c95c6f2d7286 100644 --- a/zh-cn/application-dev/application-dev-guide.md +++ b/zh-cn/application-dev/application-dev-guide.md @@ -31,7 +31,7 @@ - [网络与连接](connectivity/ipc-rpc-overview.md) - [数据管理](database/database-mdds-overview.md) - [后台代理提醒](background-agent-scheduled-reminder/background-agent-scheduled-reminder-overview.md) -- [后台任务管理](background-task-management/background-task-overview.md) +- [任务管理](task-management/background-task-overview.md) - [设备管理](device/usb-overview.md) - [设备使用信息统计](device-usage-statistics/device-usage-statistics-overview.md) - [DFX](dfx/hiappevent-overview.md) diff --git a/zh-cn/application-dev/background-task-management/Readme-CN.md b/zh-cn/application-dev/background-task-management/Readme-CN.md deleted file mode 100644 index 509366d9f7b9d1cdb06e2e6f6ca7dd012ced70e8..0000000000000000000000000000000000000000 --- a/zh-cn/application-dev/background-task-management/Readme-CN.md +++ /dev/null @@ -1,4 +0,0 @@ -# 后台任务管理 - - - [后台任务概述](background-task-overview.md) - - [后台任务开发指导](background-task-dev-guide.md) \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-mediaquery.md b/zh-cn/application-dev/reference/apis/js-apis-mediaquery.md index 8e721b186d8d5136f31977181d95e10335fa45da..dcaac2c5a72b9a67e716d25d2fe224e2c31d0dd4 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-mediaquery.md +++ b/zh-cn/application-dev/reference/apis/js-apis-mediaquery.md @@ -23,9 +23,9 @@ matchMediaSync(condition: string): MediaQueryListener 设置媒体查询的查询条件，并返回对应的监听句柄。 **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| --------- | ------ | ---- | ---------- | -| condition | string | 是 | 媒体事件的匹配条件。 | +| 参数名 | 类型 | 必填 | 说明 | +| --------- | ------ | ---- | ---------------------------------------- | +| condition | string | 是 | 媒体事件的匹配条件，具体可参考[媒体查询语法规则](/ui/ui-ts-layout-mediaquery.md#媒体查询条件语法规则)。 | **返回值：** | 类型 | 说明 | diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-search.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-search.md index d8916475ad5229f168948a17caffd1e7c0f66210..4213712676b501c3fcb3090ce10dd7b0c96d0664 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-search.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-search.md @@ -1,6 +1,8 @@ # Search -> ![](public_sys-resources/icon-note.gif) **说明：** 该组件从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 +> ![](public_sys-resources/icon-note.gif) **说明：** +> +> 该组件从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 提供搜索框组件，用于提供用户搜索内容的输入区域。 @@ -18,51 +20,51 @@ Search(options?: { value?: string; placeholder?: string; icon?: string; controll - 参数 - | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | - | -------- | -------- | -------- | -------- | -------- | - | value | string | 否 | - | 搜索文本值。 | - | placeholder | string | 否 | - | 无输入时的提示文本。| - | icon | string | 否 | - | 搜索图标路径，默认使用系统搜索图标，支持的图标格式: svg, jpg和png。 | - | controller | SearchController | 否 | - | 控制器。| + | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | + | ----------- | ---------------- | ---- | ---- | ---------------------------------------- | + | value | string | 否 | - | 搜索文本值。 | + | placeholder | string | 否 | - | 无输入时的提示文本。 | + | icon | string | 否 | - | 搜索图标路径，默认使用系统搜索图标，支持的图标格式: svg, jpg和png。 | + | controller | SearchController | 否 | - | 控制器。 | ## 属性 -| 名称 | 参数类型 | 默认值 | 描述 | -| -------- | -------- | -------- | -------- | -| searchButton | string | 无 | 搜索框末尾搜索按钮文本值，默认无搜索按钮。| -| placeholderColor | [ResourceColor](../../ui/ts-types.md) | - | 设置placeholder颜色。| -| placeholderFont | [Font](../../ui/ts-types.md) | - | 设置placeholder文本样式。| -| textFont | [Font](../../ui/ts-types.md) | - | 设置搜索框内文本样式。| +| 名称 | 参数类型 | 默认值 | 描述 | +| ---------------- | ------------------------------------- | ---- | --------------------- | +| searchButton | string | 无 | 搜索框末尾搜索按钮文本值，默认无搜索按钮。 | +| placeholderColor | [ResourceColor](../../ui/ts-types.md) | - | 设置placeholder颜色。 | +| placeholderFont | [Font](../../ui/ts-types.md) | - | 设置placeholder文本样式。 | +| textFont | [Font](../../ui/ts-types.md) | - | 设置搜索框内文本样式。 | ## 事件 -| 名称 | 功能描述 | -| -------- | -------- | -| onSubmit(callback: (value: string) => void) | 点击搜索图标、搜索按钮或者按下软键盘搜索按钮时触发。
-value: 当前输入文本框的内容。| -| onChange(callback: (value: string) => void) | 输入内容发生变化时，触发回调。
-value: 当前输入文本框的内容。| -| onCopy(callback: (value: string) => void) | 组件触发系统剪切板复制操作。
-value: 复制的文本内容。| -| onCut(callback: (value: string) => void) | 组件触发系统剪切板剪切操作。
-value: 剪切的文本内容。| -| onPaste(callback: (value: string) => void) | 组件触发系统剪切板粘贴操作。
-value: 粘贴的文本内容。| +| 名称 | 功能描述 | +| ---------------------------------------- | ---------------------------------------- | +| onSubmit(callback: (value: string) => void) | 点击搜索图标、搜索按钮或者按下软键盘搜索按钮时触发。
-value: 当前输入文本框的内容。 | +| onChange(callback: (value: string) => void) | 输入内容发生变化时，触发回调。
-value: 当前输入文本框的内容。 | +| onCopy(callback: (value: string) => void) | 组件触发系统剪切板复制操作。
-value: 复制的文本内容。 | +| onCut(callback: (value: string) => void) | 组件触发系统剪切板剪切操作。
-value: 剪切的文本内容。 | +| onPaste(callback: (value: string) => void) | 组件触发系统剪切板粘贴操作。
-value: 粘贴的文本内容。 | ## SearchController Search组件的控制器，通过它操作Search组件。 -#### 导入对象 +### 导入对象 ``` controller: SearchController = new SearchController() ``` -#### caretPosition +### caretPosition -creatPosition(value: number): viod +caretPosition(value: number): viod 设置输入光标的位置。 - 参数 - | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | - | ---- | ------ | ---- | ---- | --------------------- | + | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | + | ----- | ------ | ---- | ---- | ----------------- | | value | number | 是 | - | 从字符串开始到光标所在位置的长度。 | 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 e09b18331636eae7ba6539ce0373e4bb8f46f1bc..54950652de7e734e81f1d22f406ee059d63b35e0 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 @@ -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 | 视频播放倍速。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 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 | 视频播放倍速。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 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 c5da38006bd13fbe276f5b07436c91cf57320611..c2a52b68ca64ffd6e2f81981a7886beea89d96c4 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 @@ # 点击事件 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** -> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 +> **说明：** +> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 ## 权限列表 @@ -11,43 +11,44 @@ ## 事件 -| 名称 | 支持冒泡 | 功能描述 | -| -------- | -------- | -------- | -| 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。 | ## 示例 -``` +```ts +// xxx.ets @Entry @Component struct ClickExample { 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 988437562c8fc9ac11f0fcfd3edc61a0fa5d5954..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,37 +1,36 @@ # 拖拽事件 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** -> 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 +> **说明：** +> 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 ## 事件 -| 名称 | 支持冒泡 | 功能描述 | -| -------- | -------- | -------- | -| onDragStart(callback: (event: DragEvent, extraParams?: string) =>  [CustomBuilder](../../ui/ts-types.md)) | 否 | 第一次拖拽此事件绑定的组件时，触发回调。
event：拖拽事件信息，包括拖拽点坐标。
extraParams：拖拽事件额外信息，详见extraParam类型描述。
返回值：当前跟手效果所拖拽的对象，用于显示拖拽时的提示组件。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> - 长按150毫秒(ms)可触发拖拽事件。
> - 优先级：长按手势配置时间小于等于150毫秒(ms)时，长按手势优先触发，否则拖拽事件优先触发。 | -| onDragEnter(callback: (event: DragEvent, extraParams?: string) => void) | 否 | 拖拽进入组件范围内时，触发回调。
event：拖拽事件信息，包括拖拽点坐标。
extraParams：拖拽事件额外信息，详见extraParam类型描述。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 当监听了onDrop事件时，此事件才有效。 | -| onDragMove(callback: (event: DragEvent, extraParams?: string) => void) | 否 | 拖拽在组件范围内移动时，触发回调。
event：拖拽事件信息，包括拖拽点坐标。
extraParams：拖拽事件额外信息，详见extraParam类型描述。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 当监听了onDrop事件时，此事件才有效。 | -| onDragLeave(callback: (event: DragEvent, extraParams?: string) => void) | 否 | 拖拽离开组件范围内时，触发回调。
event：拖拽事件信息，包括拖拽点坐标。
extraParams：拖拽事件额外信息，详见extraParam类型描述。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 当监听了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开始。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 仅在ListItem组件中生效。 | - | insertIndex | number | 当前拖拽元素在List组件中放下时，insertIndex表示被拖拽元素插入该组件的第insertIndex个位置，insertIndex从0开始。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 仅在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。 | ## 示例 -``` +```ts +// xxx.ets @Entry @Component struct DragExample { 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 6c310bc063b24a73dc1d8fae1f6d596b2a1ae049..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 @@ # 按键事件 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** -> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 +> **说明：** +> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 ## 权限列表 @@ -11,58 +11,59 @@ ## 事件 -| 名称 | 支持冒泡 | 功能描述 | -| -------- | -------- | -------- | -| 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 | 确定 | 键盘的小键盘回车键。 | ## 示例 -``` +```ts +// xxx.ets @Entry @Component struct KeyEventExample { 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 3aa7ea59de2419093c0c27545d8c8b1e044eb3ba..c8a908e4b8a19388783e57c8543ebc4afdc66ed5 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 @@ -1,6 +1,6 @@ # 触摸事件 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> **说明：** > 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 @@ -11,52 +11,53 @@ ## 事件 -| 名称 | 是否冒泡 | 功能描述 | -| -------- | -------- | -------- | -| onTouch(callback: (event?: TouchEvent) => void) | 是 | 触摸动作触发该方法调用，event参数见[TouchEvent](#touchevent对象说明)介绍。 +| 名称 | 是否冒泡 | 功能描述 | +| ---------------------------------------- | ---- | ---------------------------------------- | +| onTouch(callback: (event?: TouchEvent) => void) | 是 | 触摸动作触发该方法调用，event参数见[TouchEvent](#touchevent对象说明)介绍。 | -### TouchEvent对象说明 +## TouchEvent对象说明 - 属性 - | 属性名称 | 类型 | 描述 | - | -------- | -------- | -------- | - | type | TouchType | 触摸事件的类型。 | - | touches | ArrayTouchObject> | 全部手指信息。 | - | changedTouches | ArrayTouchObject> | 当前发生变化的手指信息。 | - | timestamp | number | 事件时间戳。 | - | target8+ | [EventTarget](ts-universal-events-click.md)| 被触摸元素对象。 | + | 属性名称 | 类型 | 描述 | + | ------------------- | ---------------------------------------- | ------------ | + | type | TouchType | 触摸事件的类型。 | + | touches | Array<[TouchObject](#touchobject对象说明)> | 全部手指信息。 | + | changedTouches | Array<[TouchObject](#touchobject对象说明)> | 当前发生变化的手指信息。 | + | timestamp | number | 事件时间戳。 | + | target8+ | [EventTarget](ts-universal-events-click.md) | 被触摸元素对象。 | - 接口 - | 接口名称 | 功能描述 | - | -------- | -------- | - | stopPropagation()：void | 阻塞事件冒泡。 | + | 接口名称 | 功能描述 | + | ---------------------- | ------- | + | stopPropagation()：void | 阻塞事件冒泡。 | -- TouchObject对象说明 - | 属性名称 | 类型 | 描述 | - | -------- | -------- | -------- | - | type | TouchType | 触摸事件的类型。 | - | id | number | 手指唯一标识符。 | - | screenX | number | 触摸点相对于设备屏幕左边沿的X坐标。 | - | screenY | number | 触摸点相对于设备屏幕上边沿的Y坐标。 | - | x | number | 触摸点相对于被触摸元素左边沿的X坐标。 | - | y | number | 触摸点相对于被触摸元素上边沿的Y坐标。 | +## TouchObject对象说明 +| 属性名称 | 类型 | 描述 | +| ------- | --------------------------- | ------------------- | +| type | [TouchType](#touchtype枚举说明) | 触摸事件的类型。 | +| id | number | 手指唯一标识符。 | +| screenX | number | 触摸点相对于设备屏幕左边沿的X坐标。 | +| screenY | number | 触摸点相对于设备屏幕上边沿的Y坐标。 | +| x | number | 触摸点相对于被触摸元素左边沿的X坐标。 | +| y | number | 触摸点相对于被触摸元素上边沿的Y坐标。 | -- TouchType枚举说明 - | 名称 | 描述 | - | -------- | -------- | - | Down | 手指按下时触发。 | - | Up | 手指抬起时触发。 | - | Move | 手指按压态在屏幕上移动时触发。 | - | Cancel | 触摸事件取消时触发。 | +## TouchType枚举说明 +| 名称 | 描述 | +| ------ | --------------- | +| Down | 手指按下时触发。 | +| Up | 手指抬起时触发。 | +| Move | 手指按压态在屏幕上移动时触发。 | +| Cancel | 触摸事件取消时触发。 | ## 示例 -``` +```ts +// xxx.ets @Entry @Component struct TouchExample { 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 61fd6b4dd9ea40f60dd470fd4387f019fe943f2b..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 @@ # 鼠标事件 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** -> 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 +> **说明：** +> 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 ## 权限列表 @@ -11,45 +11,46 @@ ## 事件 -| 名称 | 支持冒泡 | 描述 | -| -------- | -------- | -------- | -| 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 | 鼠标移动。 | ## 示例 -``` +```ts +// xxx.ets @Entry @Component struct MouseEventExample { diff --git a/zh-cn/application-dev/task-management/Readme-CN.md b/zh-cn/application-dev/task-management/Readme-CN.md new file mode 100644 index 0000000000000000000000000000000000000000..0b427ead1c89aea788e91b5b5aea5f10209d166d --- /dev/null +++ b/zh-cn/application-dev/task-management/Readme-CN.md @@ -0,0 +1,12 @@ +# 任务管理 + +- 后台任务 + + - [后台任务概述](background-task-overview.md) + - [后台任务开发指导](background-task-dev-guide.md) + +- 延迟任务调度 + + - [延迟任务调度概述](work-scheduler-overview.md) + - [延迟任务调度开发指导](work-scheduler-dev-guide.md) + diff --git a/zh-cn/application-dev/background-task-management/background-task-dev-guide.md b/zh-cn/application-dev/task-management/background-task-dev-guide.md similarity index 100% rename from zh-cn/application-dev/background-task-management/background-task-dev-guide.md rename to zh-cn/application-dev/task-management/background-task-dev-guide.md diff --git a/zh-cn/application-dev/background-task-management/background-task-overview.md b/zh-cn/application-dev/task-management/background-task-overview.md similarity index 100% rename from zh-cn/application-dev/background-task-management/background-task-overview.md rename to zh-cn/application-dev/task-management/background-task-overview.md diff --git a/zh-cn/application-dev/background-task-management/public_sys-resources/icon-caution.gif b/zh-cn/application-dev/task-management/public_sys-resources/icon-caution.gif similarity index 100% rename from zh-cn/application-dev/background-task-management/public_sys-resources/icon-caution.gif rename to zh-cn/application-dev/task-management/public_sys-resources/icon-caution.gif diff --git a/zh-cn/application-dev/background-task-management/public_sys-resources/icon-danger.gif b/zh-cn/application-dev/task-management/public_sys-resources/icon-danger.gif similarity index 100% rename from zh-cn/application-dev/background-task-management/public_sys-resources/icon-danger.gif rename to zh-cn/application-dev/task-management/public_sys-resources/icon-danger.gif diff --git a/zh-cn/application-dev/background-task-management/public_sys-resources/icon-note.gif b/zh-cn/application-dev/task-management/public_sys-resources/icon-note.gif similarity index 100% rename from zh-cn/application-dev/background-task-management/public_sys-resources/icon-note.gif rename to zh-cn/application-dev/task-management/public_sys-resources/icon-note.gif diff --git a/zh-cn/application-dev/background-task-management/public_sys-resources/icon-notice.gif b/zh-cn/application-dev/task-management/public_sys-resources/icon-notice.gif similarity index 100% rename from zh-cn/application-dev/background-task-management/public_sys-resources/icon-notice.gif rename to zh-cn/application-dev/task-management/public_sys-resources/icon-notice.gif diff --git a/zh-cn/application-dev/background-task-management/public_sys-resources/icon-tip.gif b/zh-cn/application-dev/task-management/public_sys-resources/icon-tip.gif similarity index 100% rename from zh-cn/application-dev/background-task-management/public_sys-resources/icon-tip.gif rename to zh-cn/application-dev/task-management/public_sys-resources/icon-tip.gif diff --git a/zh-cn/application-dev/background-task-management/public_sys-resources/icon-warning.gif b/zh-cn/application-dev/task-management/public_sys-resources/icon-warning.gif similarity index 100% rename from zh-cn/application-dev/background-task-management/public_sys-resources/icon-warning.gif rename to zh-cn/application-dev/task-management/public_sys-resources/icon-warning.gif diff --git a/zh-cn/application-dev/work-scheduler/work-scheduler-dev-guide.md b/zh-cn/application-dev/task-management/work-scheduler-dev-guide.md similarity index 97% rename from zh-cn/application-dev/work-scheduler/work-scheduler-dev-guide.md rename to zh-cn/application-dev/task-management/work-scheduler-dev-guide.md index f55793180fccdb30586de7488f0dbfb76fc3a342..57274abd9845265e3c47368c946cde3a9fd69f81 100644 --- a/zh-cn/application-dev/work-scheduler/work-scheduler-dev-guide.md +++ b/zh-cn/application-dev/task-management/work-scheduler-dev-guide.md @@ -1,184 +1,184 @@ -# 延迟任务调度开发指导 - -## 场景介绍 - -应用要执行对实时性要求不高的任务的时候，比如设备空闲时候做一次数据学习等场景，可以使用延迟调度任务，该机制在满足应用设定条件的时候，会根据系统当前状态，如内存、功耗、热等统一决策调度时间。 - - -## 接口说明 -注册相关接口包导入： -```js -import workScheduler from '@ohos.workScheduler'; -``` - -回调相关接口包导入： -```js -import WorkSchedulerExtensionAbility from '@ohos.WorkSchedulerExtensionAbility'; -``` - -### 延迟任务调度 - -**表1** workScheduler主要接口 - -接口名 | 接口描述 ----------------------------------------------------------|----------------------------------------- -startWork(work: WorkInfo): boolean | 延迟调度任务申请 -stopWork(work: WorkInfo, needCancel?: boolean): boolean | 延迟调度任务取消 -getWorkStatus(workId: number, callback: AsyncCallback\): void| 获取延迟调度任务状态（Callback形式） -getWorkStatus(workId: number): Promise\ | 获取延迟调度任务状态（Promise形式） -obtainAllWorks(callback: AsyncCallback\): Array\| 获取所有延迟调度任务（Callback形式） -obtainAllWorks(): Promise>| 获取所有延迟调度任务（Promise形式） -stopAndClearWorks(): boolean| 停止并清除任务 -isLastWorkTimeOut(workId: number, callback: AsyncCallback\): boolean| 获取上次任务是否超时（针对RepeatWork，Callback形式） -isLastWorkTimeOut(workId: number): Promise\| 获取上次任务是否超时（针对RepeatWork，Promise形式） - -**表2** WorkInfo包含参数 - -接口名|描述|类型 ----------------------------------------------------------|-----------------------------------------|--------------------------------------------------------- -workId | 延迟任务Id（必填）|number -bundleName | 延迟任务包名（必填）|string -abilityName | 延迟任务回调通知的组件名（必填）|string -networkType | 网络类型 | NetworkType -isCharging | 是否充电 | boolean -chargerType | 充电类型 | ChargingType -batteryLevel | 电量| number -batteryStatus| 电池状态| BatteryStatus -storageRequest|存储状态| StorageRequest -isRepeat|是否循环任务| boolean -repeatCycleTime |循环间隔| number -repeatCount |循环次数| number - -**表3** 延迟任务回调接口 - -接口名 | 接口描述 ----------------------------------------------------------|----------------------------------------- -onWorkStart(work: WorkInfo): void | 延迟调度任务开始回调 -onWorkStop(work: WorkInfo): void | 延迟调度任务结束回调 - -### 开发步骤 - -**开发对应的Extension** - - import WorkSchedulerExtensionAbility from '@ohos.WorkSchedulerExtensionAbility'; - - export default class MyWorkSchedulerExtensionAbility extends WorkSchedulerExtensionAbility { - onWorkStart(workInfo) { - console.log('MyWorkSchedulerExtensionAbility onWorkStart' + JSON.stringify(workInfo)); - } - onWorkStop(workInfo) { - console.log('MyWorkSchedulerExtensionAbility onWorkStop' + JSON.stringify(workInfo)); - } - } - - -**注册延迟任务** - - - - import workScheduler from '@ohos.workScheduler'; - - let workInfo = { - workId: 1, - batteryLevel:50, - batteryStatus:workScheduler.BatteryStatus.BATTERY_STATUS_LOW, - isRepeat: false, - isPersisted: true, - bundleName: "com.example.myapplication", - abilityName: "MyExtension" - } - var res = workScheduler.startWork(workInfo); - console.info("workschedulerLog res:" + res); - - -**取消延迟任务** - - - import workScheduler from '@ohos.workScheduler'; - - let workInfo = { - workId: 1, - batteryLevel:50, - batteryStatus:workScheduler.BatteryStatus.BATTERY_STATUS_LOW, - isRepeat: false, - isPersisted: true, - bundleName: "com.example.myapplication", - abilityName: "MyExtension" - } - var res = workScheduler.stopWork(workInfo, false); - console.info("workschedulerLog res:" + res); - - -**获取指定延迟任务** - -1.Callback写法 - - workScheduler.getWorkStatus(50, (err, res) => { - if (err) { - console.info('workschedulerLog getWorkStatus failed, because:' + err.data); - } else { - for (let item in res) { - console.info('workschedulerLog getWorkStatuscallback success,' + item + ' is:' + res[item]); - } - } - }); - - -2.Promise写法 - - workScheduler.getWorkStatus(50).then((res) => { - for (let item in res) { - console.info('workschedulerLog getWorkStatus success,' + item + ' is:' + res[item]); - } - }).catch((err) => { - console.info('workschedulerLog getWorkStatus failed, because:' + err.data); - }) - - -**获取所有延迟任务** - -1.Callback写法 - - workScheduler.obtainAllWorks((err, res) =>{ - if (err) { - console.info('workschedulerLog obtainAllWorks failed, because:' + err.data); - } else { - console.info('workschedulerLog obtainAllWorks success, data is:' + JSON.stringify(res)); - } - }); - -2.Promise写法 - - workScheduler.obtainAllWorks().then((res) => { - console.info('workschedulerLog obtainAllWorks success, data is:' + JSON.stringify(res)); - }).catch((err) => { - console.info('workschedulerLog obtainAllWorks failed, because:' + err.data); - }) - -**停止并清除任务** - - let res = workScheduler.stopAndClearWorks(); - console.info("workschedulerLog res:" + res); - -**判断上次执行是否超时** - -1.Callback写法 - - workScheduler.isLastWorkTimeOut(500, (err, res) =>{ - if (err) { - console.info('workschedulerLog isLastWorkTimeOut failed, because:' + err.data); - } else { - console.info('workschedulerLog isLastWorkTimeOut success, data is:' + res); - } - }); - -2.Promise写法 - - workScheduler.isLastWorkTimeOut(500) - .then(res => { - console.info('workschedulerLog isLastWorkTimeOut success, data is:' + res); - }) - .catch(err => { - console.info('workschedulerLog isLastWorkTimeOut failed, because:' + err.data); - }); +# 延迟任务调度开发指导 + +## 场景介绍 + +应用要执行对实时性要求不高的任务的时候，比如设备空闲时候做一次数据学习等场景，可以使用延迟调度任务，该机制在满足应用设定条件的时候，会根据系统当前状态，如内存、功耗、热等统一决策调度时间。 + + +## 接口说明 +注册相关接口包导入： +```js +import workScheduler from '@ohos.workScheduler'; +``` + +回调相关接口包导入： +```js +import WorkSchedulerExtensionAbility from '@ohos.WorkSchedulerExtensionAbility'; +``` + +### 延迟任务调度 + +**表1** workScheduler主要接口 + +接口名 | 接口描述 +---------------------------------------------------------|----------------------------------------- +startWork(work: WorkInfo): boolean | 延迟调度任务申请 +stopWork(work: WorkInfo, needCancel?: boolean): boolean | 延迟调度任务取消 +getWorkStatus(workId: number, callback: AsyncCallback\): void| 获取延迟调度任务状态（Callback形式） +getWorkStatus(workId: number): Promise\ | 获取延迟调度任务状态（Promise形式） +obtainAllWorks(callback: AsyncCallback\): Array\| 获取所有延迟调度任务（Callback形式） +obtainAllWorks(): Promise>| 获取所有延迟调度任务（Promise形式） +stopAndClearWorks(): boolean| 停止并清除任务 +isLastWorkTimeOut(workId: number, callback: AsyncCallback\): boolean| 获取上次任务是否超时（针对RepeatWork，Callback形式） +isLastWorkTimeOut(workId: number): Promise\| 获取上次任务是否超时（针对RepeatWork，Promise形式） + +**表2** WorkInfo包含参数 + +接口名|描述|类型 +---------------------------------------------------------|-----------------------------------------|--------------------------------------------------------- +workId | 延迟任务Id（必填）|number +bundleName | 延迟任务包名（必填）|string +abilityName | 延迟任务回调通知的组件名（必填）|string +networkType | 网络类型 | NetworkType +isCharging | 是否充电 | boolean +chargerType | 充电类型 | ChargingType +batteryLevel | 电量| number +batteryStatus| 电池状态| BatteryStatus +storageRequest|存储状态| StorageRequest +isRepeat|是否循环任务| boolean +repeatCycleTime |循环间隔| number +repeatCount |循环次数| number + +**表3** 延迟任务回调接口 + +接口名 | 接口描述 +---------------------------------------------------------|----------------------------------------- +onWorkStart(work: WorkInfo): void | 延迟调度任务开始回调 +onWorkStop(work: WorkInfo): void | 延迟调度任务结束回调 + +### 开发步骤 + +**开发对应的Extension** + + import WorkSchedulerExtensionAbility from '@ohos.WorkSchedulerExtensionAbility'; + + export default class MyWorkSchedulerExtensionAbility extends WorkSchedulerExtensionAbility { + onWorkStart(workInfo) { + console.log('MyWorkSchedulerExtensionAbility onWorkStart' + JSON.stringify(workInfo)); + } + onWorkStop(workInfo) { + console.log('MyWorkSchedulerExtensionAbility onWorkStop' + JSON.stringify(workInfo)); + } + } + + +**注册延迟任务** + + + + import workScheduler from '@ohos.workScheduler'; + + let workInfo = { + workId: 1, + batteryLevel:50, + batteryStatus:workScheduler.BatteryStatus.BATTERY_STATUS_LOW, + isRepeat: false, + isPersisted: true, + bundleName: "com.example.myapplication", + abilityName: "MyExtension" + } + var res = workScheduler.startWork(workInfo); + console.info("workschedulerLog res:" + res); + + +**取消延迟任务** + + + import workScheduler from '@ohos.workScheduler'; + + let workInfo = { + workId: 1, + batteryLevel:50, + batteryStatus:workScheduler.BatteryStatus.BATTERY_STATUS_LOW, + isRepeat: false, + isPersisted: true, + bundleName: "com.example.myapplication", + abilityName: "MyExtension" + } + var res = workScheduler.stopWork(workInfo, false); + console.info("workschedulerLog res:" + res); + + +**获取指定延迟任务** + +1.Callback写法 + + workScheduler.getWorkStatus(50, (err, res) => { + if (err) { + console.info('workschedulerLog getWorkStatus failed, because:' + err.data); + } else { + for (let item in res) { + console.info('workschedulerLog getWorkStatuscallback success,' + item + ' is:' + res[item]); + } + } + }); + + +2.Promise写法 + + workScheduler.getWorkStatus(50).then((res) => { + for (let item in res) { + console.info('workschedulerLog getWorkStatus success,' + item + ' is:' + res[item]); + } + }).catch((err) => { + console.info('workschedulerLog getWorkStatus failed, because:' + err.data); + }) + + +**获取所有延迟任务** + +1.Callback写法 + + workScheduler.obtainAllWorks((err, res) =>{ + if (err) { + console.info('workschedulerLog obtainAllWorks failed, because:' + err.data); + } else { + console.info('workschedulerLog obtainAllWorks success, data is:' + JSON.stringify(res)); + } + }); + +2.Promise写法 + + workScheduler.obtainAllWorks().then((res) => { + console.info('workschedulerLog obtainAllWorks success, data is:' + JSON.stringify(res)); + }).catch((err) => { + console.info('workschedulerLog obtainAllWorks failed, because:' + err.data); + }) + +**停止并清除任务** + + let res = workScheduler.stopAndClearWorks(); + console.info("workschedulerLog res:" + res); + +**判断上次执行是否超时** + +1.Callback写法 + + workScheduler.isLastWorkTimeOut(500, (err, res) =>{ + if (err) { + console.info('workschedulerLog isLastWorkTimeOut failed, because:' + err.data); + } else { + console.info('workschedulerLog isLastWorkTimeOut success, data is:' + res); + } + }); + +2.Promise写法 + + workScheduler.isLastWorkTimeOut(500) + .then(res => { + console.info('workschedulerLog isLastWorkTimeOut success, data is:' + res); + }) + .catch(err => { + console.info('workschedulerLog isLastWorkTimeOut failed, because:' + err.data); + }); }) \ No newline at end of file diff --git a/zh-cn/application-dev/work-scheduler/work-scheduler-overview.md b/zh-cn/application-dev/task-management/work-scheduler-overview.md similarity index 100% rename from zh-cn/application-dev/work-scheduler/work-scheduler-overview.md rename to zh-cn/application-dev/task-management/work-scheduler-overview.md diff --git a/zh-cn/application-dev/ui/ui-ts-overview.md b/zh-cn/application-dev/ui/ui-ts-overview.md index ca3da6d6547b7cc54dfd66b5fd1392088ad4ed52..61f8805f14035f27b3729587be060d9e86eb0cde 100644 --- a/zh-cn/application-dev/ui/ui-ts-overview.md +++ b/zh-cn/application-dev/ui/ui-ts-overview.md @@ -42,7 +42,7 @@ - **语言运行时** - 选用方舟语言运行时，提供了针对UI范式语法的解析能力，提供了跨语言调用支持，提供了TS语言高性能运行环境。 + 选用方舟语言运行时，提供了针对UI范式语法的解析能力、跨语言调用支持的能力和TS语言高性能运行环境。 - **声明式UI后端引擎** diff --git a/zh-cn/application-dev/website.md b/zh-cn/application-dev/website.md index 7b4c9127ae30bb39173ca5f25f95ecf9a57146be..18674aa00a0ceadd11033f9a722ba7595fd89aa6 100644 --- a/zh-cn/application-dev/website.md +++ b/zh-cn/application-dev/website.md @@ -26,7 +26,6 @@ - [SysCap说明](quick-start/syscap.md) - - 开发 @@ -71,518 +70,520 @@ - UI开发 - [方舟开发框架（ArkUI）概述](ui/arkui-overview.md) - + - 基于JS扩展的类Web开发范式 - + - [概述](ui/ui-js-overview.md) - + - 框架说明 - + - [文件组织](ui/js-framework-file.md) - + - [js标签配置](ui/js-framework-js-tag.md) - + - [app.js](ui/js-framework-js-file.md) - + - 语法 - + - [HML语法参考](ui/js-framework-syntax-hml.md) - + - [CSS语法参考](ui/js-framework-syntax-css.md) - + - [JS语法参考](ui/js-framework-syntax-js.md) - + - [生命周期](ui/js-framework-lifecycle.md) - + - [资源限定与访问](ui/js-framework-resource-restriction.md) - + - [多语言支持](ui/js-framework-multiple-languages.md) - + - 构建用户界面 - + - [组件介绍](ui/ui-js-building-ui-component.md) - + - 构建布局 - + - [布局说明](ui/ui-js-building-ui-layout-intro.md) - + - [添加标题行和文本区域](ui/ui-js-building-ui-layout-text.md) - + - [添加图片区域](ui/ui-js-building-ui-layout-image.md) - + - [添加留言区域](ui/ui-js-building-ui-layout-comment.md) - + - [添加容器](ui/ui-js-building-ui-layout-external-container.md) - + - [添加交互](ui/ui-js-building-ui-interactions.md) - + - [动画](ui/ui-js-building-ui-animation.md) - + - [手势事件](ui/ui-js-building-ui-event.md) - + - [页面路由](ui/ui-js-building-ui-routes.md) - + - 常见组件开发指导 - + - 容器组件 - + - [List开发指导](ui/ui-js-components-list.md) - + - [Dialog开发指导](ui/ui-js-components-dialog.md) - + - [Form开发指导](ui/ui-js-components-form.md) - + - [Stepper开发指导](ui/ui-js-components-stepper.md) - + - [Tabs开发指导](ui/ui-js-component-tabs.md) - + - [Swiper开发指导](ui/ui-js-components-swiper.md) - + - 基础组件 - + - [Text开发指导](ui/ui-js-components-text.md) - + - [Input开发指导](ui/ui-js-components-input.md) - + - [Button开发指导](ui/ui-js-components-button.md) - + - [Picker开发指导](ui/ui-js-components-picker.md) - + - [Image开发指导](ui/ui-js-components-images.md) - + - [Image-animator开发指导](ui/ui-js-components-image-animator.md) - + - [Rating开发指导](ui/ui-js-components-rating.md) - + - [Slider开发指导](ui/ui-js-components-slider.md) - + - [Chart开发指导](ui/ui-js-components-chart.md) - + - [Switch开发指导](ui/ui-js-components-switch.md) - + - [Toolbar开发指导](ui/ui-js-components-toolbar.md) - + - [Menu开发指导](ui/ui-js-components-menu.md) - + - [Marquee开发指导](ui/ui-js-components-marquee.md) - + - [Qrcode开发指导](ui/ui-js-components-qrcode.md) - + - [Search开发指导](ui/ui-js-components-search.md) - + - Canvas开发指导 - + - [Canvas对象](ui/ui-js-components-canvas.md) - + - [CanvasRenderingContext2D对象](ui/ui-js-components-canvasrenderingcontext2d.md) - + - [Path2D对象](ui/ui-js-components-path2d.md) - + - [OffscreenCanvas对象](ui/ui-js-components-offscreencanvas.md) - + - [栅格布局](ui/ui-js-components-grid.md) - + - Svg开发指导 - + - [基础知识](ui/ui-js-components-svg-overview.md) - + - [绘制图形](ui/ui-js-components-svg-graphics.md) - + - [绘制路径](ui/ui-js-components-svg-path.md) - + - [绘制文本](ui/ui-js-components-svg-text.md) - + - 动效开发指导 - + - CSS动画 - + - [属性样式动画](ui/ui-js-animate-attribute-style.md) - + - [transform样式动画](ui/ui-js-animate-transform.md) - + - [background-position样式动画](ui/ui-js-animate-background-position-style.md) - + - [svg动画](ui/ui-js-animate-svg.md) - + - JS动画 - + - [组件动画](ui/ui-js-animate-component.md) - + - 插值器动画 - + - [动画动效](ui/ui-js-animate-dynamic-effects.md) - + - [动画帧](ui/ui-js-animate-frame.md) - + - [自定义组件](ui/ui-js-custom-components.md) - + - 基于TS扩展的声明式开发范式 - + - [概述](ui/ui-ts-overview.md) - + - 框架说明 - + - 文件组织 - + - [目录结构](ui/ts-framework-directory.md) - + - [应用代码文件访问规则](ui/ts-framework-file-access-rules.md) - + - [js标签配置](ui/ts-framework-js-tag.md) - + - 资源访问 - + - [访问应用资源](ui/ts-application-resource-access.md) - + - [访问系统资源](ui/ts-system-resource-access.md) - + - [媒体资源类型说明](ui/ts-media-resource-type.md) - + - [像素单位](ui/ts-pixel-units.md) - + - [类型定义](ui/ts-types.md) - + - 声明式语法 - + - [描述规范使用说明](ui/ts-syntax-intro.md) - + - 通用UI描述规范 - + - [基本概念](ui/ts-general-ui-concepts.md) - + - 声明式UI描述规范 - + - [无构造参数配置](ui/ts-parameterless-configuration.md) - + - [必选参数构造配置](ui/ts-configuration-with-mandatory-parameters.md) - + - [属性配置](ui/ts-attribution-configuration.md) - + - [事件配置](ui/ts-event-configuration.md) - + - [子组件配置](ui/ts-child-component-configuration.md) - + - 组件化 - + - [@Component](ui/ts-component-based-component.md) - + - [@Entry](ui/ts-component-based-entry.md) - + - [@Preview](ui/ts-component-based-preview.md) - + - [@Builder](ui/ts-component-based-builder.md) - + - [@Extend](ui/ts-component-based-extend.md) - + - [@CustomDialog](ui/ts-component-based-customdialog.md) - + - [@Styles](ui/ts-component-based-styles.md) - + - UI状态管理 - + - [基本概念](ui/ts-ui-state-mgmt-concepts.md) - + - 管理组件拥有的状态 - + - [@State](ui/ts-component-states-state.md) - + - [@Prop](ui/ts-component-states-prop.md) - + - [@Link](ui/ts-component-states-link.md) - + - 管理应用程序的状态 - + - [应用程序的数据存储](ui/ts-application-states-appstorage.md) - + - [持久化数据管理](ui/ts-application-states-apis-persistentstorage.md) - + - [环境变量](ui/ts-application-states-apis-environment.md) - + - 其他类目的状态管理 - + - [Observed和ObjectLink数据管理](ui/ts-other-states-observed-objectlink.md) - + - [@Consume和@Provide数据管理](ui/ts-other-states-consume-provide.md) - + - [@Watch](ui/ts-other-states-watch.md) - + - 渲染控制语法 - + - [条件渲染](ui/ts-rending-control-syntax-if-else.md) - + - [循环渲染](ui/ts-rending-control-syntax-foreach.md) - + - [数据懒加载](ui/ts-rending-control-syntax-lazyforeach.md) - + - 深入理解组件化 - + - [build函数](ui/ts-function-build.md) - + - [自定义组件初始化](ui/ts-custom-component-initialization.md) - + - [自定义组件生命周期回调函数](ui/ts-custom-component-lifecycle-callbacks.md) - + - [组件创建和重新初始化示例](ui/ts-component-creation-re-initialization.md) - + - [语法糖](ui/ts-syntactic-sugar.md) - + - 常见组件开发指导 - + - [Button开发指导](ui/ui-ts-basic-components-button.md) - + - [Web开发指导](ui/ui-ts-components-web.md) - + - 常见布局开发指导 - + - [弹性布局](ui/ui-ts-layout-flex.md) - + - [栅格布局](ui/ui-ts-layout-grid-container.md) - + - [媒体查询](ui/ui-ts-layout-mediaquery.md) - + - 体验声明式UI - + - [创建声明式UI工程](ui/ui-ts-creating-project.md) - + - [初识Component](ui/ui-ts-components.md) - + - [创建简单视图](ui/ui-ts-creating-simple-page.md) - + - 页面布局与连接 - + - [构建食物数据模型](ui/ui-ts-building-data-model.md) - + - [构建食物列表List布局](ui/ui-ts-building-category-list-layout.md) - + - [构建食物分类Grid布局](ui/ui-ts-building-category-grid-layout.md) - + - [页面跳转与数据传递](ui/ui-ts-page-redirection-data-transmission.md) - 公共事件与通知 - [公共事件与通知概述](notification/notification-brief.md) - + - [公共事件开发指导](notification/common-event.md) - + - [通知开发指导](notification/notification-guidelines.md) - + - [调试助手使用指导](notification/assistant-guidelines.md) - 窗口管理 - + - 窗口 - + - [窗口开发概述](windowmanager/window-overview.md) - + - [窗口开发指导](windowmanager/window-guidelines.md) - + - 屏幕属性 - + - [屏幕属性开发概述](windowmanager/display-overview.md) - + - [屏幕属性开发指导](windowmanager/display-guidelines.md) - + - 屏幕截图 - + - [屏幕截图开发概述](windowmanager/screenshot-overview.md) - + - [屏幕截图开发指导](windowmanager/screenshot-guidelines.md) - WebGL - [WebGL开发概述](webgl/webgl-overview.md) - + - [WebGL开发指导](webgl/webgl-guidelines.md) - + - 媒体 - + - 音频 - + - [音频开发概述](media/audio-overview.md) - + - [音频播放开发指导](media/audio-playback.md) - + - [音频录制开发指导](media/audio-recorder.md) - + - [音频渲染开发指导](media/audio-renderer.md) - + - [音频采集开发指导](media/audio-capturer.md) - + - 视频 - + - [视频播放开发指导](media/video-playback.md) - + - [视频录制开发指导](media/video-recorder.md) - 图片 - + - [图片开发指导](media/image.md) - + - 安全 - + - 用户认证 - + - [用户认证开发概述](security/userauth-overview.md) - + - [用户认证开发指导](security/userauth-guidelines.md) - 密钥管理 - + - [HUKS开发概述](security/huks-overview.md) - + - [HUKS开发指导](security/huks-guidelines.md) - Hap包签名工具 - + - [Hap包签名工具指导](security/hapsigntool-guidelines.md) - 访问控制 - + - [访问控制开发概述](security/accesstoken-overview.md) - + - [访问控制开发指导](security/accesstoken-guidelines.md) - + - 网络与连接 - + - 网络管理 - + - [网络管理开发概述](connectivity/net-mgmt-overview.md) - + - [HTTP数据请求](connectivity/http-request.md) - + - [WebSocket连接](connectivity/websocket-connection.md) - + - [Socket连接](connectivity/socket-connection.md) - + - IPC与RPC通信 - + - [IPC与RPC通信概述](connectivity/ipc-rpc-overview.md) - + - [IPC与RPC通信开发指导](connectivity/ipc-rpc-development-guideline.md) - + - [远端状态订阅开发实例](connectivity/subscribe-remote-state.md) - + - 电话服务 - + - [电话服务开发概述](telephony/telephony-overview.md) - + - [跳转拨号界面](telephony/jumping-to-the-dial-screen.md) - + - [获取当前蜂窝网络信号信息](telephony/cellular-network-signal-info.md) - + - 数据管理 - 分布式数据服务 - + - [分布式数据服务概述](database/database-mdds-overview.md) - + - [分布式数据服务开发指导](database/database-mdds-guidelines.md) - + - 关系型数据库 - + - [关系型数据库概述](database/database-relational-overview.md) - + - [关系型数据库开发指导](database/database-relational-guidelines.md) - + - 轻量级数据存储 - + - [轻量级数据存储概述](database/database-storage-overview.md) - + - [轻量级数据存储开发指导](database/database-storage-guidelines.md) - + - 分布式数据对象 - + - [分布式数据对象概述](database/database-distributedobject-overview.md) - + - [分布式数据对象开发指导](database/database-distributedobject-guidelines.md) - + - 后台代理提醒 - [后台代理提醒概述](background-agent-scheduled-reminder/background-agent-scheduled-reminder-overview.md) - + - [后台代理提醒开发指导](background-agent-scheduled-reminder/background-agent-scheduled-reminder-guide.md) - - - 后台任务管理 - - - [后台任务概述](background-task-management/background-task-overview.md) - - - [后台任务开发指导](background-task-management/background-task-dev-guide.md) - - - 延迟任务调度 - - - [延迟任务调度概述](work-scheduler/work-scheduler-overview.md) - - - [延迟任务调度开发指导](work-scheduler/work-scheduler-dev-guide.md) - + + - 任务管理 + + - 后台任务管理 + + - [后台任务概述](background-task-management/background-task-overview.md) + + - [后台任务开发指导](background-task-management/background-task-dev-guide.md) + + - 延迟任务调度 + + - [延迟任务调度概述](work-scheduler/work-scheduler-overview.md) + + - [延迟任务调度开发指导](work-scheduler/work-scheduler-dev-guide.md) + - 设备管理 - USB服务 - + - [USB服务开发概述](device/usb-overview.md) - + - [USB服务开发指导](device/usb-guidelines.md) - + - 位置 - + - [位置开发概述](device/device-location-overview.md) - + - [获取设备的位置信息](device/device-location-info.md) - + - [（逆）地理编码转化](device/device-location-geocoding.md) - + - 传感器 - + - [传感器开发概述](device/sensor-overview.md) - + - [传感器开发指导](device/sensor-guidelines.md) - + - 振动 - + - [振动开发概述](device/vibrator-overview.md) - + - [振动开发指导](device/vibrator-guidelines.md) - + - 设备使用信息统计 - [设备使用信息统计概述](device-usage-statistics/device-usage-statistics-overview.md) - + - [设备使用信息统计开发指导](device-usage-statistics/device-usage-statistics-dev-guide.md) - + - DFX - + - 应用事件打点 - + - [应用事件打点概述](dfx/hiappevent-overview.md) - + - [应用事件打点开发指导](dfx/hiappevent-guidelines.md) - + - 性能打点跟踪 - + - [性能打点跟踪概述](dfx/hitracemeter-overview.md) - + - [性能打点跟踪开发指导](dfx/hitracemeter-guidelines.md) - + - 分布式跟踪 - + - [分布式跟踪概述](dfx/hitracechain-overview.md) - + - [分布式跟踪开发指导](dfx/hitracechain-guidelines.md) - + - 国际化 - [国际化开发概述](internationalization/international-overview.md) - + - [Intl开发指导](internationalization/intl-guidelines.md) - + - [I18n开发指导](internationalization/i18n-guidelines.md) - Native API的相关指导 - [Native API在应用工程中的使用指导](napi/napi-guidelines.md) - + - [Drawing开发指导](napi/drawing-guidelines.md) - + - [Rawfile开发指导](napi/rawfile-guidelines.md) - 工具 @@ -599,503 +600,503 @@ - 组件参考（基于JS扩展的类Web开发范式） - 组件 - + - 通用 - + - [通用属性](reference/arkui-js/js-components-common-attributes.md) - + - [通用样式](reference/arkui-js/js-components-common-styles.md) - + - [通用事件](reference/arkui-js/js-components-common-events.md) - + - [通用方法](reference/arkui-js/js-components-common-methods.md) - + - [动画样式](reference/arkui-js/js-components-common-animation.md) - + - [渐变样式](reference/arkui-js/js-components-common-gradient.md) - + - [转场样式](reference/arkui-js/js-components-common-transition.md) - + - [媒体查询](reference/arkui-js/js-components-common-mediaquery.md) - + - [自定义字体样式](reference/arkui-js/js-components-common-customizing-font.md) - + - [原子布局](reference/arkui-js/js-components-common-atomic-layout.md) - + - 容器组件 - + - [badge](reference/arkui-js/js-components-container-badge.md) - + - [dialog](reference/arkui-js/js-components-container-dialog.md) - + - [div](reference/arkui-js/js-components-container-div.md) - + - [form](reference/arkui-js/js-components-container-form.md) - + - [list](reference/arkui-js/js-components-container-list.md) - + - [list-item](reference/arkui-js/js-components-container-list-item.md) - + - [list-item-group](reference/arkui-js/js-components-container-list-item-group.md) - + - [panel](reference/arkui-js/js-components-container-panel.md) - + - [popup](reference/arkui-js/js-components-container-popup.md) - + - [refresh](reference/arkui-js/js-components-container-refresh.md) - + - [stack](reference/arkui-js/js-components-container-stack.md) - + - [stepper](reference/arkui-js/js-components-container-stepper.md) - + - [stepper-item](reference/arkui-js/js-components-container-stepper-item.md) - + - [swiper](reference/arkui-js/js-components-container-swiper.md) - + - [tabs](reference/arkui-js/js-components-container-tabs.md) - + - [tab-bar](reference/arkui-js/js-components-container-tab-bar.md) - + - [tab-content](reference/arkui-js/js-components-container-tab-content.md) - + - 基础组件 - + - [button](reference/arkui-js/js-components-basic-button.md) - + - [chart](reference/arkui-js/js-components-basic-chart.md) - + - [divider](reference/arkui-js/js-components-basic-divider.md) - + - [image](reference/arkui-js/js-components-basic-image.md) - + - [image-animator](reference/arkui-js/js-components-basic-image-animator.md) - + - [input](reference/arkui-js/js-components-basic-input.md) - + - [label](reference/arkui-js/js-components-basic-label.md) - + - [marquee](reference/arkui-js/js-components-basic-marquee.md) - + - [menu](reference/arkui-js/js-components-basic-menu.md) - + - [option](reference/arkui-js/js-components-basic-option.md) - + - [picker](reference/arkui-js/js-components-basic-picker.md) - + - [picker-view](reference/arkui-js/js-components-basic-picker-view.md) - + - [piece](reference/arkui-js/js-components-basic-piece.md) - + - [progress](reference/arkui-js/js-components-basic-progress.md) - + - [qrcode](reference/arkui-js/js-components-basic-qrcode.md) - + - [rating](reference/arkui-js/js-components-basic-rating.md) - + - [richtext](reference/arkui-js/js-components-basic-richtext.md) - + - [search](reference/arkui-js/js-components-basic-search.md) - + - [select](reference/arkui-js/js-components-basic-select.md) - + - [slider](reference/arkui-js/js-components-basic-slider.md) - + - [span](reference/arkui-js/js-components-basic-span.md) - + - [switch](reference/arkui-js/js-components-basic-switch.md) - + - [text](reference/arkui-js/js-components-basic-text.md) - + - [textarea](reference/arkui-js/js-components-basic-textarea.md) - + - [toolbar](reference/arkui-js/js-components-basic-toolbar.md) - + - [toolbar-item](reference/arkui-js/js-components-basic-toolbar-item.md) - + - [toggle](reference/arkui-js/js-components-basic-toggle.md) - + - [web](reference/arkui-js/js-components-basic-web.md) - + - 媒体组件 - + - [video](reference/arkui-js/js-components-media-video.md) - + - 画布组件 - + - [canvas组件](reference/arkui-js/js-components-canvas-canvas.md) - + - [CanvasRenderingContext2D对象](reference/arkui-js/js-components-canvas-canvasrenderingcontext2d.md) - + - [Image对象](reference/arkui-js/js-components-canvas-image.md) - + - [CanvasGradient对象](reference/arkui-js/js-components-canvas-canvasgradient.md) - + - [ImageData对象](reference/arkui-js/js-components-canvas-imagedata.md) - + - [Path2D对象](reference/arkui-js/js-components-canvas-path2d.md) - + - [ImageBitmap对象](reference/arkui-js/js-components-canvas-imagebitmap.md) - + - [OffscreenCanvas对象](reference/arkui-js/js-components-canvas-offscreencanvas.md) - + - [OffscreenCanvasRenderingContext2D对象](reference/arkui-js/js-offscreencanvasrenderingcontext2d.md) - + - 栅格组件 - + - [基本概念](reference/arkui-js/js-components-grid-basic-concepts.md) - + - [grid-container](reference/arkui-js/js-components-grid-container.md) - + - [grid-row](reference/arkui-js/js-components-grid-row.md) - + - [grid-col](reference/arkui-js/js-components-grid-col.md) - + - svg组件 - + - [通用属性](reference/arkui-js/js-components-svg-common-attributes.md) - + - [svg](reference/arkui-js/js-components-svg.md) - + - [rect](reference/arkui-js/js-components-svg-rect.md) - + - [circle](reference/arkui-js/js-components-svg-circle.md) - + - [ellipse](reference/arkui-js/js-components-svg-ellipse.md) - + - [path](reference/arkui-js/js-components-svg-path.md) - + - [line](reference/arkui-js/js-components-svg-line.md) - + - [polyline](reference/arkui-js/js-components-svg-polyline.md) - + - [polygon](reference/arkui-js/js-components-svg-polygon.md) - + - [text](reference/arkui-js/js-components-svg-text.md) - + - [tspan](reference/arkui-js/js-components-svg-tspan.md) - + - [textPath](reference/arkui-js/js-components-svg-textpath.md) - + - [animate](reference/arkui-js/js-components-svg-animate.md) - + - [animateMotion](reference/arkui-js/js-components-svg-animatemotion.md) - + - [animateTransform](reference/arkui-js/js-components-svg-animatetransform.md) - + - 自定义组件 - + - [基本用法](reference/arkui-js/js-components-custom-basic-usage.md) - + - [自定义事件](reference/arkui-js/js-components-custom-events.md) - + - [Props](reference/arkui-js/js-components-custom-props.md) - + - [事件参数](reference/arkui-js/js-components-custom-event-parameter.md) - + - [slot插槽](reference/arkui-js/js-components-custom-slot.md) - + - [生命周期定义](reference/arkui-js/js-components-custom-lifecycle.md) - + - 附录 - + - [类型说明](reference/arkui-js/js-appendix-types.md) - 组件参考（基于TS扩展的声明式开发范式） - 组件 - + - 通用 - + - 通用事件 - + - [点击事件](reference/arkui-ts/ts-universal-events-click.md) - + - [触摸事件](reference/arkui-ts/ts-universal-events-touch.md) - + - [挂载卸载事件](reference/arkui-ts/ts-universal-events-show-hide.md) - + - [拖拽事件](reference/arkui-ts/ts-universal-events-drag-drop.md) - + - [按键事件](reference/arkui-ts/ts-universal-events-key.md) - + - [焦点事件](reference/arkui-ts/ts-universal-focus-event.md) - + - [鼠标事件](reference/arkui-ts/ts-universal-mouse-key.md) - + - [组件区域变化事件](reference/arkui-ts/ts-universal-component-area-change-event.md) - + - 通用属性 - + - [尺寸设置](reference/arkui-ts/ts-universal-attributes-size.md) - + - [位置设置](reference/arkui-ts/ts-universal-attributes-location.md) - + - [布局约束](reference/arkui-ts/ts-universal-attributes-layout-constraints.md) - + - [Flex布局](reference/arkui-ts/ts-universal-attributes-flex-layout.md) - + - [边框设置](reference/arkui-ts/ts-universal-attributes-border.md) - + - [背景设置](reference/arkui-ts/ts-universal-attributes-background.md) - + - [透明度设置](reference/arkui-ts/ts-universal-attributes-opacity.md) - + - [显隐控制](reference/arkui-ts/ts-universal-attributes-visibility.md) - + - [禁用控制](reference/arkui-ts/ts-universal-attributes-enable.md) - + - [浮层](reference/arkui-ts/ts-universal-attributes-overlay.md) - + - [Z序控制](reference/arkui-ts/ts-universal-attributes-z-order.md) - + - [图形变换](reference/arkui-ts/ts-universal-attributes-transformation.md) - + - [图像效果](reference/arkui-ts/ts-universal-attributes-image-effect.md) - + - [形状裁剪](reference/arkui-ts/ts-universal-attributes-sharp-clipping.md) - + - [文本样式设置](reference/arkui-ts/ts-universal-attributes-text-style.md) - + - [栅格设置](reference/arkui-ts/ts-universal-attributes-grid.md) - + - [颜色渐变](reference/arkui-ts/ts-universal-attributes-gradient-color.md) - + - [Popup控制](reference/arkui-ts/ts-universal-attributes-popup.md) - + - [Menu控制](reference/arkui-ts/ts-universal-attributes-menu.md) - + - [点击控制](reference/arkui-ts/ts-universal-attributes-click.md) - + - [焦点控制](reference/arkui-ts/ts-universal-attributes-focus.md) - + - [悬浮态效果](reference/arkui-ts/ts-universal-attributes-hover-effect.md) - + - [组件标识](reference/arkui-ts/ts-universal-attributes-component-id.md) - + - [触摸热区设置](reference/arkui-ts/ts-universal-attributes-touch-target.md) - + - [多态样式](reference/arkui-ts/ts-universal-attributes-polymorphic-style.md) - + - 手势处理 - + - [绑定手势方法](reference/arkui-ts/ts-gesture-settings.md) - + - 基础手势 - + - [TapGesture](reference/arkui-ts/ts-basic-gestures-tapgesture.md) - + - [LongPressGesture](reference/arkui-ts/ts-basic-gestures-longpressgesture.md) - + - [PanGesture](reference/arkui-ts/ts-basic-gestures-pangesture.md) - + - [PinchGesture](reference/arkui-ts/ts-basic-gestures-pinchgesture.md) - + - [RotationGesture](reference/arkui-ts/ts-basic-gestures-rotationgesture.md) - + - [SwipeGesture](reference/arkui-ts/ts-basic-gestures-swipegesture.md) - + - [组合手势](reference/arkui-ts/ts-combined-gestures.md) - + - 基础组件 - + - [Blank](reference/arkui-ts/ts-basic-components-blank.md) - + - [Button](reference/arkui-ts/ts-basic-components-button.md) - + - [Checkbox](reference/arkui-ts/ts-basic-components-checkbox.md) - + - [CheckboxGroup](reference/arkui-ts/ts-basic-components-checkboxgroup.md) - + - [DataPanel](reference/arkui-ts/ts-basic-components-datapanel.md) - + - [DatePicker](reference/arkui-ts/ts-basic-components-datepicker.md) - + - [Divider](reference/arkui-ts/ts-basic-components-divider.md) - + - [Gauge](reference/arkui-ts/ts-basic-components-gauge.md) - + - [Image](reference/arkui-ts/ts-basic-components-image.md) - + - [ImageAnimator](reference/arkui-ts/ts-basic-components-imageanimator.md) - + - [LoadingProgress](reference/arkui-ts/ts-basic-components-loadingprogress.md) - + - [Marquee](reference/arkui-ts/ts-basic-components-marquee.md) - + - [Navigation](reference/arkui-ts/ts-basic-components-navigation.md) - + - [PatternLock](reference/arkui-ts/ts-basic-components-patternlock.md) - + - [PluginComponent](reference/arkui-ts/ts-basic-components-plugincomponent.md) - + - [Progress](reference/arkui-ts/ts-basic-components-progress.md) - + - [QRCode](reference/arkui-ts/ts-basic-components-qrcode.md) - + - [Radio](reference/arkui-ts/ts-basic-components-radio.md) - + - [Rating](reference/arkui-ts/ts-basic-components-rating.md) - + - [RichText](reference/arkui-ts/ts-basic-components-richtext.md) - + - [ScrollBar](reference/arkui-ts/ts-basic-components-scrollbar.md) - + - [Search](reference/arkui-ts/ts-basic-components-search.md) - + - [Select](reference/arkui-ts/ts-basic-components-select.md) - + - [Slider](reference/arkui-ts/ts-basic-components-slider.md) - + - [Span](reference/arkui-ts/ts-basic-components-span.md) - + - [Stepper](reference/arkui-ts/ts-basic-components-stepper.md) - + - [StepperItem](reference/arkui-ts/ts-basic-components-stepperitem.md) - + - [Text](reference/arkui-ts/ts-basic-components-text.md) - + - [TextArea](reference/arkui-ts/ts-basic-components-textarea.md) - + - [TextClock](reference/arkui-ts/ts-basic-components-textclock.md) - + - [TextInput](reference/arkui-ts/ts-basic-components-textinput.md) - + - [TextPicker](reference/arkui-ts/ts-basic-components-textpicker.md) - + - [TextTimer](reference/arkui-ts/ts-basic-components-texttimer.md) - + - [TimePicker](reference/arkui-ts/ts-basic-components-timepicker.md) - + - [Toggle](reference/arkui-ts/ts-basic-components-toggle.md) - + - [Web](reference/arkui-ts/ts-basic-components-web.md) - + - [Xcomponent](reference/arkui-ts/ts-basic-components-xcomponent.md) - + - 容器组件 - + - [AlphabetIndexer](reference/arkui-ts/ts-container-alphabet-indexer.md) - + - [Badge](reference/arkui-ts/ts-container-badge.md) - + - [Column](reference/arkui-ts/ts-container-column.md) - + - [ColumnSplit](reference/arkui-ts/ts-container-columnsplit.md) - + - [Counter](reference/arkui-ts/ts-container-counter.md) - + - [Flex](reference/arkui-ts/ts-container-flex.md) - + - [GridContainer](reference/arkui-ts/ts-container-gridcontainer.md) - + - [Grid](reference/arkui-ts/ts-container-grid.md) - + - [GridItem](reference/arkui-ts/ts-container-griditem.md) - + - [List](reference/arkui-ts/ts-container-list.md) - + - [ListItem](reference/arkui-ts/ts-container-listitem.md) - + - [Navigator](reference/arkui-ts/ts-container-navigator.md) - + - [Panel](reference/arkui-ts/ts-container-panel.md) - + - [Refresh](reference/arkui-ts/ts-container-refresh.md) - + - [Row](reference/arkui-ts/ts-container-row.md) - + - [RowSplit](reference/arkui-ts/ts-container-rowsplit.md) - + - [Scroll](reference/arkui-ts/ts-container-scroll.md) - + - [SideBarContainer](reference/arkui-ts/ts-container-sidebarcontainer.md) - + - [Stack](reference/arkui-ts/ts-container-stack.md) - + - [Swiper](reference/arkui-ts/ts-container-swiper.md) - + - [Tabs](reference/arkui-ts/ts-container-tabs.md) - + - [TabContent](reference/arkui-ts/ts-container-tabcontent.md) - + - 媒体组件 - + - [Video](reference/arkui-ts/ts-media-components-video.md) - + - 绘制组件 - + - [Circle](reference/arkui-ts/ts-drawing-components-circle.md) - + - [Ellipse](reference/arkui-ts/ts-drawing-components-ellipse.md) - + - [Line](reference/arkui-ts/ts-drawing-components-line.md) - + - [Polyline](reference/arkui-ts/ts-drawing-components-polyline.md) - + - [Polygon](reference/arkui-ts/ts-drawing-components-polygon.md) - + - [Path](reference/arkui-ts/ts-drawing-components-path.md) - + - [Rect](reference/arkui-ts/ts-drawing-components-rect.md) - + - [Shape](reference/arkui-ts/ts-drawing-components-shape.md) - + - 画布组件 - + - [Canvas](reference/arkui-ts/ts-components-canvas-canvas.md) - + - [CanvasRenderingContext2D对象](reference/arkui-ts/ts-canvasrenderingcontext2d.md) - + - [OffscreenCanvasRenderingConxt2D对象](reference/arkui-ts/ts-offscreencanvasrenderingcontext2d.md) - + - [Lottie](reference/arkui-ts/ts-components-canvas-lottie.md) - + - [Path2D对象](reference/arkui-ts/ts-components-canvas-path2d.md) - + - [CanvasGradient对象](reference/arkui-ts/ts-components-canvas-canvasgradient.md) - + - [ImageBitmap对象](reference/arkui-ts/ts-components-canvas-imagebitmap.md) - + - [ImageData对象](reference/arkui-ts/ts-components-canvas-imagedata.md) - + - 动画 - + - [属性动画](reference/arkui-ts/ts-animatorproperty.md) - + - [显式动画](reference/arkui-ts/ts-explicit-animation.md) - + - 转场动画 - + - [页面间转场](reference/arkui-ts/ts-page-transition-animation.md) - + - [组件内转场](reference/arkui-ts/ts-transition-animation-component.md) - + - [共享元素转场](reference/arkui-ts/ts-transition-animation-shared-elements.md) - + - [路径动画](reference/arkui-ts/ts-motion-path-animation.md) - + - [矩阵变换](reference/arkui-ts/ts-matrix-transformation.md) - + - [插值计算](reference/arkui-ts/ts-interpolation-calculation.md) - + - 全局UI方法 - + - 弹窗 - + - [警告弹窗](reference/arkui-ts/ts-methods-alert-dialog-box.md) - + - [列表选择弹窗](reference/arkui-ts/ts-methods-action-sheet.md) - + - [自定义弹窗](reference/arkui-ts/ts-methods-custom-dialog-box.md) - + - [日期选择弹窗](reference/arkui-ts/ts-methods-datepicker-dialog.md) - + - [时间选择弹窗](reference/arkui-ts/ts-methods-timepicker-dialog.md) - + - [文本选择弹窗](reference/arkui-ts/ts-methods-textpicker-dialog.md) - + - [菜单](reference/arkui-ts/ts-methods-menu.md) - + - [文档中涉及到的内置枚举值](reference/arkui-ts/ts-appendix-enums.md) - 接口参考（JS及TS API） @@ -1134,7 +1135,7 @@ - [@ohos.application.formInfo (FormInfo)](reference/apis/js-apis-formInfo.md) - [@ohos.application.missionManager (missionManager)](reference/apis/js-apis-missionManager.md) - + - [@ohos.application.missioninfo (missioninfo)](reference/apis/js-apis-application-missionInfo.md) - [@ohos.application.formProvider (FormProvider)](reference/apis/js-apis-formprovider.md) diff --git a/zh-cn/application-dev/work-scheduler/Readme-CN.md b/zh-cn/application-dev/work-scheduler/Readme-CN.md deleted file mode 100644 index 0beef070025fb38b64b43aaa1770732048cc6955..0000000000000000000000000000000000000000 --- a/zh-cn/application-dev/work-scheduler/Readme-CN.md +++ /dev/null @@ -1,4 +0,0 @@ -# 延迟任务调度 - -- [延迟任务调度概述](work-scheduler-overview.md) -- [延迟任务调度开发指导](work-scheduler-dev-guide.md) \ No newline at end of file