Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
301894a4
D
Docs
项目概览
OpenHarmony
/
Docs
接近 2 年 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
未验证
提交
301894a4
编写于
5月 15, 2023
作者:
O
openharmony_ci
提交者:
Gitee
5月 15, 2023
浏览文件
操作
浏览文件
下载
差异文件
!18162 卡片事件文档问题修复
Merge pull request !18162 from wangkailong/callee
上级
7b87eebe
a823beaf
变更
6
隐藏空白更改
内联
并排
Showing
6 changed file
with
14 addition
and
21 deletion
+14
-21
zh-cn/application-dev/application-models/Readme-CN.md
zh-cn/application-dev/application-models/Readme-CN.md
+3
-3
zh-cn/application-dev/application-models/arkts-ui-widget-event-call.md
...tion-dev/application-models/arkts-ui-widget-event-call.md
+1
-1
zh-cn/application-dev/application-models/arkts-ui-widget-event-formextensionability.md
...tion-models/arkts-ui-widget-event-formextensionability.md
+2
-2
zh-cn/application-dev/application-models/arkts-ui-widget-event-overview.md
...-dev/application-models/arkts-ui-widget-event-overview.md
+2
-10
zh-cn/application-dev/application-models/arkts-ui-widget-event-router.md
...on-dev/application-models/arkts-ui-widget-event-router.md
+3
-2
zh-cn/application-dev/application-models/arkts-ui-widget-event-uiability.md
...dev/application-models/arkts-ui-widget-event-uiability.md
+3
-3
未找到文件。
zh-cn/application-dev/application-models/Readme-CN.md
浏览文件 @
301894a4
...
...
@@ -36,10 +36,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
)
...
...
zh-cn/application-dev/application-models/arkts-ui-widget-event-call.md
浏览文件 @
301894a4
# 使用call事件拉起指定UIAbility到后台
许多应用希望借助卡片的能力,实现和应用在前台时相同的功能。例如音乐卡片,卡片上提供播放、暂停等按钮,点击不同按钮将触发音乐应用的不同功能,进而提高用户的体验。在卡片中使用
**postCardAction**
接口的call能力,能够将卡片提供方应用拉到后台。同时,call能力提供了调用应用指定方法、传递数据的功能,使应用在后台运行时可以通过卡片上的按钮执行不同的功能。
许多应用希望借助卡片的能力,实现和应用在前台时相同的功能。例如音乐卡片,卡片上提供播放、暂停等按钮,点击不同按钮将触发音乐应用的不同功能,进而提高用户的体验。在卡片中使用
**postCardAction**
接口的call能力,能够将卡片提供方应用
的指定的UIAbility
拉到后台。同时,call能力提供了调用应用指定方法、传递数据的功能,使应用在后台运行时可以通过卡片上的按钮执行不同的功能。
通常使用按钮控件来触发call事件,示例代码如下:
...
...
zh-cn/application-dev/application-models/arkts-ui-widget-event-formextensionability.md
浏览文件 @
301894a4
# 通过
FormExtensionAbility
刷新卡片内容
# 通过
message事件
刷新卡片内容
在卡片页面中可以通过
**postCardAction**
接口触发message事件
至
FormExtensionAbility,然后由FormExtensionAbility刷新卡片内容,下面是这种刷新方式的简单示例。
在卡片页面中可以通过
**postCardAction**
接口触发message事件
拉起
FormExtensionAbility,然后由FormExtensionAbility刷新卡片内容,下面是这种刷新方式的简单示例。
-
在卡片页面通过注册Button的onClick点击事件回调,并在回调中调用
**postCardAction**
接口触发事件至FormExtensionAbility。
...
...
zh-cn/application-dev/application-models/arkts-ui-widget-event-overview.md
浏览文件 @
301894a4
...
...
@@ -21,7 +21,7 @@ action参数说明:
|
**Key**
|
**Value**
|
**样例描述**
|
| -------- | -------- | -------- |
| "action" | string | action的类型,支持三种预定义的类型:
<br/>
-
"router":
应用跳转,触发后会跳转到对应UIAbility,仅允许跳转到当前应用的UIAbility。
<br/>
-
"message":自定义消息,触发后会调用提供方FormExtensionAbility的[onFormEvent()](../reference/apis/js-apis-app-form-formExtensionAbility.md#onformevent)生命周期回调。
<br/>
-
"call":应用非前台启动,触发后会启动当前应用的UIAbility,但不会调度到前台,call的目标
应用需要具备后台运行权限(
[
ohos.permission.KEEP_BACKGROUND_RUNNING
](
../security/permission-list.md#ohospermissionkeep_background_running
)
)。 |
| "action" | string | action的类型,支持三种预定义的类型:
<br/>
-
"router":
跳转到提供方应用的指定UIAbility。
<br/>
-
"message":自定义消息,触发后会调用提供方FormExtensionAbility的[onFormEvent()](../reference/apis/js-apis-app-form-formExtensionAbility.md#onformevent)生命周期回调。
<br/>
-
"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名,必填。 |
...
...
@@ -61,13 +61,5 @@ 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
)
以下介绍通过卡片事件实现的典型开发场景。
zh-cn/application-dev/application-models/arkts-ui-widget-event-router.md
浏览文件 @
301894a4
# 使用router事件跳转到指定
页面
# 使用router事件跳转到指定
UIAbility
在卡片中使用
**postCardAction**
接口的router能力,能够快速拉起卡片提供方应用,因此页面较多的应用往往会通过卡片提供不同的跳转按钮,实现一键直达的效果。例如相机卡片,卡片上提供拍照、录像等按钮,点击不同按钮将拉起相机应用的不同页面,从而提高用户的体验。
在卡片中使用
**postCardAction**
接口的router能力,能够快速拉起卡片提供方应用的指定UIAbility,因此UIAbility较多的应用往往会通过卡片提供不同的跳转按钮,实现一键直达的效果。例如相机卡片,卡片上提供拍照、录像等按钮,点击不同按钮将拉起相机应用的不同UIAbility,从而提高用户的体验。

...
...
zh-cn/application-dev/application-models/arkts-ui-widget-event-uiability.md
浏览文件 @
301894a4
# 通过
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。
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录