未验证 提交 4e0a14e1 编写于 作者: O openharmony_ci 提交者: Gitee

!11838 格式修改

Merge pull request !11838 from LiAn/master
...@@ -27,6 +27,7 @@ create(options: AnimatorOptions): AnimatorResult ...@@ -27,6 +27,7 @@ create(options: AnimatorOptions): AnimatorResult
| options | [AnimatorOptions](#animatoroptions) | 是 | 定义动画选项。 | | options | [AnimatorOptions](#animatoroptions) | 是 | 定义动画选项。 |
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| --------------------------------- | ------------- | | --------------------------------- | ------------- |
| [AnimatorResult](#animatorresult) | Animator结果接口。 | | [AnimatorResult](#animatorresult) | Animator结果接口。 |
...@@ -51,8 +52,6 @@ create(options: AnimatorOptions): AnimatorResult ...@@ -51,8 +52,6 @@ create(options: AnimatorOptions): AnimatorResult
定义Animator结果接口。 定义Animator结果接口。
<span id = "#resetsup9sup"></span>
### reset<sup>9+</sup> ### reset<sup>9+</sup>
reset(options: AnimatorOptions): void reset(options: AnimatorOptions): void
...@@ -71,7 +70,7 @@ reset(options: AnimatorOptions): void ...@@ -71,7 +70,7 @@ reset(options: AnimatorOptions): void
以下错误码的详细介绍请参见[ohos.animator(动画)](../errorcodes/errorcode-animator.md)错误码。 以下错误码的详细介绍请参见[ohos.animator(动画)](../errorcodes/errorcode-animator.md)错误码。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| --------- | ------- | | --------- | ------- |
| 100001 | Internal error. | | 100001 | Internal error. |
...@@ -181,6 +180,7 @@ onframe: (progress: number) => void ...@@ -181,6 +180,7 @@ onframe: (progress: number) => void
| progress | number | 是 | 动画的当前进度。 | | progress | number | 是 | 动画的当前进度。 |
**示例:** **示例:**
```js ```js
let animatorResult = animator.create(options) let animatorResult = animator.create(options)
animatorResult.onframe = function(value) { animatorResult.onframe = function(value) {
...@@ -208,7 +208,7 @@ animatorResult.onfinish = function() { ...@@ -208,7 +208,7 @@ animatorResult.onfinish = function() {
### oncancel ### oncancel
oncancel: () => void oncancel: () => void
不再维护
动画被取消时回调。 动画被取消时回调。
**系统能力:** SystemCapability.ArkUI.ArkUI.Full **系统能力:** SystemCapability.ArkUI.ArkUI.Full
...@@ -247,7 +247,7 @@ animatorResult.onrepeat = function() { ...@@ -247,7 +247,7 @@ animatorResult.onrepeat = function() {
**系统能力:** SystemCapability.ArkUI.ArkUI.Full **系统能力:** SystemCapability.ArkUI.ArkUI.Full
| 名称 | 参数类型 | 必填 | 说明 | | 名称 | 类型 | 必填 | 说明 |
| ---------- | ---------------------------------------- | ---- | ---------------------------------------- | | ---------- | ---------------------------------------- | ---- | ---------------------------------------- |
| duration | number | 是 | 动画播放的时长,单位毫秒,默认为0。 | | duration | number | 是 | 动画播放的时长,单位毫秒,默认为0。 |
| easing | string | 是 | 动画插值曲线,默认为'ease'。 | | easing | string | 是 | 动画插值曲线,默认为'ease'。 |
......
...@@ -14,11 +14,6 @@ import mediaquery from '@ohos.mediaquery' ...@@ -14,11 +14,6 @@ import mediaquery from '@ohos.mediaquery'
``` ```
## 权限
## mediaquery.matchMediaSync ## mediaquery.matchMediaSync
matchMediaSync(condition: string): MediaQueryListener matchMediaSync(condition: string): MediaQueryListener
...@@ -28,19 +23,22 @@ matchMediaSync(condition: string): MediaQueryListener ...@@ -28,19 +23,22 @@ matchMediaSync(condition: string): MediaQueryListener
**系统能力:** SystemCapability.ArkUI.ArkUI.Full **系统能力:** SystemCapability.ArkUI.ArkUI.Full
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| --------- | ------ | ---- | ---------------------------------------- | | --------- | ------ | ---- | ---------------------------------------- |
| condition | string | 是 | 媒体事件的匹配条件,具体可参考[媒体查询语法规则](../../ui/ui-ts-layout-mediaquery.md#语法规则)。 | | condition | string | 是 | 媒体事件的匹配条件,具体可参考[媒体查询语法规则](../../ui/ui-ts-layout-mediaquery.md#语法规则)。 |
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------ | ---------------------- | | ------------------ | ---------------------- |
| MediaQueryListener | 媒体事件监听句柄,用于注册和去注册监听回调。 | | MediaQueryListener | 媒体事件监听句柄,用于注册和去注册监听回调。 |
**示例:** **示例:**
```js
```js
let listener = mediaquery.matchMediaSync('(orientation: landscape)'); //监听横屏事件 let listener = mediaquery.matchMediaSync('(orientation: landscape)'); //监听横屏事件
``` ```
## MediaQueryListener ## MediaQueryListener
...@@ -66,12 +64,14 @@ on(type: 'change', callback: Callback&lt;MediaQueryResult&gt;): void ...@@ -66,12 +64,14 @@ on(type: 'change', callback: Callback&lt;MediaQueryResult&gt;): void
**系统能力:** SystemCapability.ArkUI.ArkUI.Full **系统能力:** SystemCapability.ArkUI.ArkUI.Full
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------------------- | ---- | ---------------- | | -------- | -------------------------------- | ---- | ---------------- |
| type | string | 是 | 必须填写字符串'change'。 | | type | string | 是 | 必须填写字符串'change'。 |
| callback | Callback&lt;MediaQueryResult&gt; | 是 | 向媒体查询注册的回调 | | callback | Callback&lt;MediaQueryResult&gt; | 是 | 向媒体查询注册的回调 |
**示例:** **示例:**
详见[off示例](#off) 详见[off示例](#off)
...@@ -84,12 +84,14 @@ off(type: 'change', callback?: Callback&lt;MediaQueryResult&gt;): void ...@@ -84,12 +84,14 @@ off(type: 'change', callback?: Callback&lt;MediaQueryResult&gt;): void
**系统能力:** SystemCapability.ArkUI.ArkUI.Full **系统能力:** SystemCapability.ArkUI.ArkUI.Full
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------------------- | ---- | ----------------------------- | | -------- | -------------------------------- | ---- | ----------------------------- |
| type | boolean | 是 | 必须填写字符串'change'。 | | type | boolean | 是 | 必须填写字符串'change'。 |
| callback | Callback&lt;MediaQueryResult&gt; | 否 | 需要去注册的回调,如果参数缺省则去注册该句柄下所有的回调。 | | callback | Callback&lt;MediaQueryResult&gt; | 否 | 需要去注册的回调,如果参数缺省则去注册该句柄下所有的回调。 |
**示例:** **示例:**
```js ```js
import mediaquery from '@ohos.mediaquery' import mediaquery from '@ohos.mediaquery'
......
...@@ -30,7 +30,7 @@ showToast(options: ShowToastOptions): void ...@@ -30,7 +30,7 @@ showToast(options: ShowToastOptions): void
以下错误码的详细介绍请参见[ohos.promptAction(弹窗)](../errorcodes/errorcode-promptAction.md)错误码。 以下错误码的详细介绍请参见[ohos.promptAction(弹窗)](../errorcodes/errorcode-promptAction.md)错误码。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| --------- | ------- | | --------- | ------- |
| 100001 | Internal error. | | 100001 | Internal error. |
...@@ -86,7 +86,7 @@ showDialog(options: ShowDialogOptions): Promise&lt;ShowDialogSuccessResponse&gt; ...@@ -86,7 +86,7 @@ showDialog(options: ShowDialogOptions): Promise&lt;ShowDialogSuccessResponse&gt;
以下错误码的详细介绍请参见[ohos.promptAction(弹窗)](../errorcodes/errorcode-promptAction.md)错误码。 以下错误码的详细介绍请参见[ohos.promptAction(弹窗)](../errorcodes/errorcode-promptAction.md)错误码。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| --------- | ------- | | --------- | ------- |
| 100001 | Internal error. | | 100001 | Internal error. |
...@@ -140,7 +140,7 @@ showDialog(options: ShowDialogOptions, callback: AsyncCallback&lt;ShowDialogSucc ...@@ -140,7 +140,7 @@ showDialog(options: ShowDialogOptions, callback: AsyncCallback&lt;ShowDialogSucc
以下错误码的详细介绍请参见[ohos.promptAction(弹窗)](../errorcodes/errorcode-promptAction.md)错误码。 以下错误码的详细介绍请参见[ohos.promptAction(弹窗)](../errorcodes/errorcode-promptAction.md)错误码。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| --------- | ------- | | --------- | ------- |
| 100001 | Internal error. | | 100001 | Internal error. |
...@@ -216,7 +216,7 @@ showActionMenu(options: ActionMenuOptions, callback: AsyncCallback&lt;ActionMenu ...@@ -216,7 +216,7 @@ showActionMenu(options: ActionMenuOptions, callback: AsyncCallback&lt;ActionMenu
以下错误码的详细介绍请参见[ohos.promptAction(弹窗)](../errorcodes/errorcode-promptAction.md)错误码。 以下错误码的详细介绍请参见[ohos.promptAction(弹窗)](../errorcodes/errorcode-promptAction.md)错误码。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| --------- | ------- | | --------- | ------- |
| 100001 | Internal error. | | 100001 | Internal error. |
...@@ -274,7 +274,7 @@ showActionMenu(options: ActionMenuOptions): Promise&lt;ActionMenuSuccessResponse ...@@ -274,7 +274,7 @@ showActionMenu(options: ActionMenuOptions): Promise&lt;ActionMenuSuccessResponse
以下错误码的详细介绍请参见[ohos.promptAction(弹窗)](../errorcodes/errorcode-promptAction.md)错误码。 以下错误码的详细介绍请参见[ohos.promptAction(弹窗)](../errorcodes/errorcode-promptAction.md)错误码。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| --------- | ------- | | --------- | ------- |
| 100001 | Internal error. | | 100001 | Internal error. |
......
...@@ -38,7 +38,7 @@ pushUrl(options: RouterOptions): Promise&lt;void&gt; ...@@ -38,7 +38,7 @@ pushUrl(options: RouterOptions): Promise&lt;void&gt;
以下错误码的详细介绍请参见[ohos.router(页面路由)](../errorcodes/errorcode-router.md)错误码。 以下错误码的详细介绍请参见[ohos.router(页面路由)](../errorcodes/errorcode-router.md)错误码。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| --------- | ------- | | --------- | ------- |
| 100001 | Internal error. | | 100001 | Internal error. |
| 100002 | Uri error. The uri of router is not exist. | | 100002 | Uri error. The uri of router is not exist. |
...@@ -87,7 +87,7 @@ pushUrl(options: RouterOptions, callback: AsyncCallback&lt;void&gt;): void ...@@ -87,7 +87,7 @@ pushUrl(options: RouterOptions, callback: AsyncCallback&lt;void&gt;): void
以下错误码的详细介绍请参见[ohos.router(页面路由)](../errorcodes/errorcode-router.md)错误码。 以下错误码的详细介绍请参见[ohos.router(页面路由)](../errorcodes/errorcode-router.md)错误码。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| --------- | ------- | | --------- | ------- |
| 100001 | Internal error. | | 100001 | Internal error. |
| 100002 | Uri error. The uri of router is not exist. | | 100002 | Uri error. The uri of router is not exist. |
...@@ -141,7 +141,7 @@ pushUrl(options: RouterOptions, mode: RouterMode): Promise&lt;void&gt; ...@@ -141,7 +141,7 @@ pushUrl(options: RouterOptions, mode: RouterMode): Promise&lt;void&gt;
以下错误码的详细介绍请参见[ohos.router(页面路由)](../errorcodes/errorcode-router.md)错误码。 以下错误码的详细介绍请参见[ohos.router(页面路由)](../errorcodes/errorcode-router.md)错误码。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| --------- | ------- | | --------- | ------- |
| 100001 | Internal error. | | 100001 | Internal error. |
| 100002 | Uri error. The uri of router is not exist. | | 100002 | Uri error. The uri of router is not exist. |
...@@ -191,7 +191,7 @@ pushUrl(options: RouterOptions, mode: RouterMode, callback: AsyncCallback&lt;voi ...@@ -191,7 +191,7 @@ pushUrl(options: RouterOptions, mode: RouterMode, callback: AsyncCallback&lt;voi
以下错误码的详细介绍请参见[ohos.router(页面路由)](../errorcodes/errorcode-router.md)错误码。 以下错误码的详细介绍请参见[ohos.router(页面路由)](../errorcodes/errorcode-router.md)错误码。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| --------- | ------- | | --------- | ------- |
| 100001 | Internal error. | | 100001 | Internal error. |
| 100002 | Uri error. The uri of router is not exist. | | 100002 | Uri error. The uri of router is not exist. |
...@@ -245,7 +245,7 @@ replaceUrl(options: RouterOptions): Promise&lt;void&gt; ...@@ -245,7 +245,7 @@ replaceUrl(options: RouterOptions): Promise&lt;void&gt;
以下错误码的详细介绍请参见[ohos.router(页面路由)](../errorcodes/errorcode-router.md)错误码。 以下错误码的详细介绍请参见[ohos.router(页面路由)](../errorcodes/errorcode-router.md)错误码。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| --------- | ------- | | --------- | ------- |
| 100001 | Internal error. | | 100001 | Internal error. |
| 200002 | Uri error. The uri of router is not exist. | | 200002 | Uri error. The uri of router is not exist. |
...@@ -290,7 +290,7 @@ replaceUrl(options: RouterOptions, callback: AsyncCallback&lt;void&gt;): void ...@@ -290,7 +290,7 @@ replaceUrl(options: RouterOptions, callback: AsyncCallback&lt;void&gt;): void
以下错误码的详细介绍请参见[ohos.router(页面路由)](../errorcodes/errorcode-router.md)错误码。 以下错误码的详细介绍请参见[ohos.router(页面路由)](../errorcodes/errorcode-router.md)错误码。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| --------- | ------- | | --------- | ------- |
| 100001 | Internal error. | | 100001 | Internal error. |
| 200002 | Uri error. The uri of router is not exist. | | 200002 | Uri error. The uri of router is not exist. |
...@@ -342,7 +342,7 @@ replaceUrl(options: RouterOptions, mode: RouterMode): Promise&lt;void&gt; ...@@ -342,7 +342,7 @@ replaceUrl(options: RouterOptions, mode: RouterMode): Promise&lt;void&gt;
以下错误码的详细介绍请参见[ohos.router(页面路由)](../errorcodes/errorcode-router.md)错误码。 以下错误码的详细介绍请参见[ohos.router(页面路由)](../errorcodes/errorcode-router.md)错误码。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| --------- | ------- | | --------- | ------- |
| 100001 | Internal error. | | 100001 | Internal error. |
| 200002 | Uri error. The uri of router is not exist. | | 200002 | Uri error. The uri of router is not exist. |
...@@ -388,7 +388,7 @@ replaceUrl(options: RouterOptions, mode: RouterMode, callback: AsyncCallback&lt; ...@@ -388,7 +388,7 @@ replaceUrl(options: RouterOptions, mode: RouterMode, callback: AsyncCallback&lt;
以下错误码的详细介绍请参见[ohos.router(页面路由)](../errorcodes/errorcode-router.md)错误码。 以下错误码的详细介绍请参见[ohos.router(页面路由)](../errorcodes/errorcode-router.md)错误码。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| --------- | ------- | | --------- | ------- |
| 100001 | Internal error. | | 100001 | Internal error. |
| 200002 | Uri error. The uri of router is not exist. | | 200002 | Uri error. The uri of router is not exist. |
...@@ -522,7 +522,7 @@ enableBackPageAlert(options: EnableAlertOptions): void ...@@ -522,7 +522,7 @@ enableBackPageAlert(options: EnableAlertOptions): void
以下错误码的详细介绍请参见[ohos.router(页面路由)](../errorcodes/errorcode-router.md)错误码。 以下错误码的详细介绍请参见[ohos.router(页面路由)](../errorcodes/errorcode-router.md)错误码。
| 错误码ID | 错误信息 | | 错误码ID | 错误信息 |
| --------- | ------- | | --------- | ------- |
| 100001 | Internal error. | | 100001 | Internal error. |
......
## 申请能效资源 # 申请能效资源
### 场景说明 ## 场景说明
在实际的系统中,存在一些重要性高的系统应用,虽然此类应用相比普通应用具有一定的特权,但为了进一步平衡系统的功耗开销,这些应用同样需要支持在后台可被挂起。但对于系统特权应用,为了避免挂起后重要功能受到影响,提供了独立的能效资源申请接口,使这些特权应用可以在后台执行一些特殊的任务和使用特定的系统资源,例如在被挂起期间如果仍然希望能够收到系统公共事件,可以使用能效资源接口向系统申请使用公共事件资源。 在实际的系统中,存在一些重要性高的系统应用,虽然此类应用相比普通应用具有一定的特权,但为了进一步平衡系统的功耗开销,这些应用同样需要支持在后台可被挂起。但对于系统特权应用,为了避免挂起后重要功能受到影响,提供了独立的能效资源申请接口,使这些特权应用可以在后台执行一些特殊的任务和使用特定的系统资源,例如在被挂起期间如果仍然希望能够收到系统公共事件,可以使用能效资源接口向系统申请使用公共事件资源。
对于需要升级为特权应用的,开发者需要合理评估自己的业务诉求,向应用中心提出申请。 对于需要升级为特权应用的,开发者需要合理评估自己的业务诉求,向应用中心提出申请。
### 接口说明 ## 接口说明
**表1** 申请能效资源主要接口 **表1** 申请能效资源主要接口
...@@ -16,7 +16,7 @@ ...@@ -16,7 +16,7 @@
| resetAllEfficiencyResources():void | 释放申请的能效资源。 | | resetAllEfficiencyResources():void | 释放申请的能效资源。 |
### 开发步骤 ## 开发步骤
1、当特权应用需要在后台使用特殊资源时。向系统申请目标资源。 1、当特权应用需要在后台使用特殊资源时。向系统申请目标资源。
......
...@@ -6,7 +6,7 @@ ...@@ -6,7 +6,7 @@
| ---------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | | ---------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 准备开发环境 | 了解声明式UI的工程结构。<br>了解资源分类与访问。 | [OpenHarmony工程介绍](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ohos-project-overview-0000001218440650)<br>[资源分类与访问](../quick-start/resource-categories-and-access.md) | | 准备开发环境 | 了解声明式UI的工程结构。<br>了解资源分类与访问。 | [OpenHarmony工程介绍](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ohos-project-overview-0000001218440650)<br>[资源分类与访问](../quick-start/resource-categories-and-access.md) |
| 学习ArkTS语言 | ArkTS是HarmonyOS优选的主力应用开发语言,当前,ArkTS在TS基础上主要扩展了声明式UI能力。 | [学习ArkTS语言](../quick-start/arkts-get-started.md) | | 学习ArkTS语言 | ArkTS是HarmonyOS优选的主力应用开发语言,当前,ArkTS在TS基础上主要扩展了声明式UI能力。 | [学习ArkTS语言](../quick-start/arkts-get-started.md) |
| 开发页面 | 根据页面的使用场景,选择合适的布局。<br>根据页面需要实现的内容,添加系统内置组件,并修改组件样式。<br>更新页面内容,丰富页面展现形式。 | [创建页面](#创建页面)<br> [常见布局开发指导](ui-ts-layout-linear.md)<br> [常见组件说明](ui-ts-components-intro.md)<br>[修改组件样式](#修改组件样式)<br>[更新页面内容](#更新页面内容) | | 开发页面 | 根据页面的使用场景,选择合适的布局。<br>根据页面需要实现的内容,添加系统内置组件,并修改组件样式。<br>更新页面内容,丰富页面展现形式。 | [创建页面](#创建页面)<br> &nbsp;&nbsp;[常见布局开发指导](ui-ts-layout-linear.md)<br> &nbsp;&nbsp;[常见组件说明](ui-ts-components-intro.md)<br>[修改组件样式](#修改组件样式)<br>[更新页面内容](#更新页面内容) |
| (可选)页面多样化 | 绘图和动画。 | [绘图组件](../reference/arkui-ts/ts-drawing-components-circle.md)<br>[画布组件](../reference/arkui-ts/ts-components-canvas-canvas.md)<br>[动画](../reference/arkui-ts/ts-animatorproperty.md) | | (可选)页面多样化 | 绘图和动画。 | [绘图组件](../reference/arkui-ts/ts-drawing-components-circle.md)<br>[画布组件](../reference/arkui-ts/ts-components-canvas-canvas.md)<br>[动画](../reference/arkui-ts/ts-animatorproperty.md) |
| (可选)页面之间的跳转 | 使用页面路由实现多个页面之前的跳转。 | [页面路由](../reference/apis/js-apis-router.md) | | (可选)页面之间的跳转 | 使用页面路由实现多个页面之前的跳转。 | [页面路由](../reference/apis/js-apis-router.md) |
| (可选)性能提升 | 避免低性能代码对应用的性能造成负面影响。 | [性能提升的推荐方法](ui-ts-performance-improvement-recommendation.md) | | (可选)性能提升 | 避免低性能代码对应用的性能造成负面影响。 | [性能提升的推荐方法](ui-ts-performance-improvement-recommendation.md) |
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册