diff --git a/zh-cn/application-dev/application-models/Readme-CN.md b/zh-cn/application-dev/application-models/Readme-CN.md index 3436b002f631f0c83667b34ded70c0e347e7d421..ba28aa160b14a45f5c40a330d6a602b3c01d846b 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 f011aa6547fa69f88f9e779eb621f1caf8915c8c..50e43ab959093891ccb81408864faf66ce4957fd 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 ab376c0ea9312e34c52632c17c88339b2e8f06fa..295e6773e56f4bc2fcddaf8d14867db35f75b07b 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 98867645bcd25a31126b0bc43909c9aad4b7a9c0..053e5e4354218f5f5f46ce6fa1e1c0930aa54b47 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 82588a66874482e44a46e2ed669b99d5ba2fb9a7..3f3531d6ea75c2bdc8be75fdb45d58b6a70247c3 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 fb42de0b4bf5409daad0ea58b22c4da9dce1929c..756be318be9d1175747327ee7b177b0a98cbf528 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。