From d3926ecf47dd07206a54d0c13e09ffe9d71ee395 Mon Sep 17 00:00:00 2001 From: wangkailong Date: Fri, 12 May 2023 16:59:27 +0800 Subject: [PATCH] =?UTF-8?q?call=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: wangkailong Change-Id: I1c20c3060903d6a7a9a1c3d750d79fa1d4fec705 --- .../application-dev/application-models/Readme-CN.md | 6 +++--- .../arkts-ui-widget-event-call.md | 2 +- .../arkts-ui-widget-event-formextensionability.md | 4 ++-- .../arkts-ui-widget-event-overview.md | 13 ++----------- .../arkts-ui-widget-event-router.md | 4 ++-- .../arkts-ui-widget-event-uiability.md | 6 +++--- 6 files changed, 13 insertions(+), 22 deletions(-) diff --git a/zh-cn/application-dev/application-models/Readme-CN.md b/zh-cn/application-dev/application-models/Readme-CN.md index 3436b002f6..ba28aa160b 100644 --- a/zh-cn/application-dev/application-models/Readme-CN.md +++ b/zh-cn/application-dev/application-models/Readme-CN.md @@ -37,10 +37,10 @@ - [卡片使用自定义绘制能力](arkts-ui-widget-page-custom-drawing.md) - 开发卡片事件 - [卡片事件能力说明](arkts-ui-widget-event-overview.md) - - [通过FormExtensionAbility刷新卡片内容](arkts-ui-widget-event-formextensionability.md) - - [使用router事件跳转到指定页面](arkts-ui-widget-event-router.md) + - [使用router事件跳转到指定UIAbility](arkts-ui-widget-event-router.md) - [使用call事件拉起指定UIAbility到后台](arkts-ui-widget-event-call.md) - - [通过UIAbility刷新卡片内容](arkts-ui-widget-event-uiability.md) + - [通过message事件刷新卡片内容](arkts-ui-widget-event-formextensionability.md) + - [通过router或call事件刷新卡片内容](arkts-ui-widget-event-uiability.md) - 卡片数据交互 - [卡片数据交互说明](arkts-ui-widget-interaction-overview.md) - [定时刷新和定点刷新](arkts-ui-widget-update-by-time.md) diff --git a/zh-cn/application-dev/application-models/arkts-ui-widget-event-call.md b/zh-cn/application-dev/application-models/arkts-ui-widget-event-call.md index f011aa6547..50e43ab959 100644 --- a/zh-cn/application-dev/application-models/arkts-ui-widget-event-call.md +++ b/zh-cn/application-dev/application-models/arkts-ui-widget-event-call.md @@ -1,7 +1,7 @@ # 使用call事件拉起指定UIAbility到后台 -许多应用希望借助卡片的能力，实现和应用在前台时相同的功能。例如音乐卡片，卡片上提供播放、暂停等按钮，点击不同按钮将触发音乐应用的不同功能，进而提高用户的体验。在卡片中使用**postCardAction**接口的call能力，能够将卡片提供方应用拉到后台。同时，call能力提供了调用应用指定方法、传递数据的功能，使应用在后台运行时可以通过卡片上的按钮执行不同的功能。 +许多应用希望借助卡片的能力，实现和应用在前台时相同的功能。例如音乐卡片，卡片上提供播放、暂停等按钮，点击不同按钮将触发音乐应用的不同功能，进而提高用户的体验。在卡片中使用**postCardAction**接口的call能力，能够将卡片提供方应用的指定的UIAbility拉到后台。同时，call能力提供了调用应用指定方法、传递数据的功能，使应用在后台运行时可以通过卡片上的按钮执行不同的功能。 通常使用按钮控件来触发call事件，示例代码如下： diff --git a/zh-cn/application-dev/application-models/arkts-ui-widget-event-formextensionability.md b/zh-cn/application-dev/application-models/arkts-ui-widget-event-formextensionability.md index ab376c0ea9..295e6773e5 100644 --- a/zh-cn/application-dev/application-models/arkts-ui-widget-event-formextensionability.md +++ b/zh-cn/application-dev/application-models/arkts-ui-widget-event-formextensionability.md @@ -1,7 +1,7 @@ -# 通过FormExtensionAbility刷新卡片内容 +# 通过message事件刷新卡片内容 -在卡片页面中可以通过**postCardAction**接口触发message事件至FormExtensionAbility，然后由FormExtensionAbility刷新卡片内容，下面是这种刷新方式的简单示例。 +在卡片页面中可以通过**postCardAction**接口触发message事件拉起FormExtensionAbility，然后由FormExtensionAbility刷新卡片内容，下面是这种刷新方式的简单示例。 - 在卡片页面通过注册Button的onClick点击事件回调，并在回调中调用**postCardAction**接口触发事件至FormExtensionAbility diff --git a/zh-cn/application-dev/application-models/arkts-ui-widget-event-overview.md b/zh-cn/application-dev/application-models/arkts-ui-widget-event-overview.md index 98867645bc..053e5e4354 100644 --- a/zh-cn/application-dev/application-models/arkts-ui-widget-event-overview.md +++ b/zh-cn/application-dev/application-models/arkts-ui-widget-event-overview.md @@ -24,7 +24,7 @@ action参数说明： | **Key** | **Value** | **样例描述** | | -------- | -------- | -------- | -| "action" | string | action的类型，支持三种预定义的类型：
- "router"：应用跳转，触发后会跳转到对应UIAbility，仅允许跳转到当前应用的UIAbility。
- "message"：自定义消息，触发后会调用提供方FormExtensionAbility的[onFormEvent()](../reference/apis/js-apis-app-form-formExtensionAbility.md#onformevent)生命周期回调。
- "call"：应用非前台启动，触发后会启动当前应用的UIAbility，但不会调度到前台，call的目标应用需要具备后台运行权限([ohos.permission.KEEP_BACKGROUND_RUNNING](../security/permission-list.md#ohospermissionkeep_background_running))。 | +| "action" | string | action的类型，支持三种预定义的类型：
- "router"：跳转到提供方应用的指定UIAbility。
- "message"：自定义消息，触发后会调用提供方FormExtensionAbility的[onFormEvent()](../reference/apis/js-apis-app-form-formExtensionAbility.md#onformevent)生命周期回调。
- "call"：后台启动提供方应用。触发后会拉起提供方应用的指定UIAbility，但不会调度到前台。提供方应用需要具备后台运行权限([ohos.permission.KEEP_BACKGROUND_RUNNING](../security/permission-list.md#ohospermissionkeep_background_running))。 | | "bundleName" | string | "router" / "call" 类型时跳转的包名，可选。 | | "moduleName" | string | "router" / "call" 类型时跳转的模块名，可选。 | | "abilityName" | string | "router" / "call" 类型时跳转的UIAbility名，必填。 | @@ -68,13 +68,4 @@ Button('拉至后台') ``` -以下是卡片开发过程中可以通过卡片事件实现的典型开发场景： - - -- [通过FormExtensionAbility刷新卡片内容](arkts-ui-widget-event-formextensionability.md) - -- [通过UIAbility刷新卡片内容](arkts-ui-widget-event-uiability.md) - -- [使用router事件跳转到指定页面](arkts-ui-widget-event-router.md) - -- [使用call事件拉起指定UIAbility到后台](arkts-ui-widget-event-call.md) +以下介绍通过卡片事件实现的典型开发场景。 diff --git a/zh-cn/application-dev/application-models/arkts-ui-widget-event-router.md b/zh-cn/application-dev/application-models/arkts-ui-widget-event-router.md index 82588a6687..3f3531d6ea 100644 --- a/zh-cn/application-dev/application-models/arkts-ui-widget-event-router.md +++ b/zh-cn/application-dev/application-models/arkts-ui-widget-event-router.md @@ -1,7 +1,7 @@ -# 使用router事件跳转到指定页面 +# 使用router事件跳转到指定UIAbility -在卡片中使用**postCardAction**接口的router能力，能够快速拉起卡片提供方应用，因此页面较多的应用往往会通过卡片提供不同的跳转按钮，实现一键直达的效果。例如相机卡片，卡片上提供拍照、录像等按钮，点击不同按钮将拉起相机应用的不同页面，从而提高用户的体验。 +在卡片中使用**postCardAction**接口的router能力，能够快速拉起卡片提供方应用的指定UIAbility，因此UIAbility较多的应用往往会通过卡片提供不同的跳转按钮，实现一键直达的效果。例如相机卡片，卡片上提供拍照、录像等按钮，点击不同按钮将拉起相机应用的不同UIAbility，从而提高用户的体验。 ![WidgerCameraCard](figures/WidgerCameraCard.png) diff --git a/zh-cn/application-dev/application-models/arkts-ui-widget-event-uiability.md b/zh-cn/application-dev/application-models/arkts-ui-widget-event-uiability.md index fb42de0b4b..756be318be 100644 --- a/zh-cn/application-dev/application-models/arkts-ui-widget-event-uiability.md +++ b/zh-cn/application-dev/application-models/arkts-ui-widget-event-uiability.md @@ -1,9 +1,9 @@ -# 通过UIAbility刷新卡片内容 +# 通过router或call事件刷新卡片内容 在卡片页面中可以通过**postCardAction**接口触发router事件或者call事件拉起UIAbility，然后由UIAbility刷新卡片内容，下面是这种刷新方式的简单示例。 -## 通过postCardAction接口触发router事件 +## 通过router事件刷新卡片内容 - 在卡片页面通过注册Button的onClick点击事件回调，并在回调中调用**postCardAction**接口触发router事件至FormExtensionAbility。 @@ -86,7 +86,7 @@ } ``` -## 通过postCardAction接口触发call事件 +## 通过call事件刷新卡片内容 - 在使用**postCardAction**接口的call事件时，需要在FormExtensionAbility中的onAddForm生命周期回调中更新formId。 -- GitLab