卡片事件能力说明
ArkTS卡片中提供了postCardAction()接口用于卡片内部和提供方应用间的交互，当前支持router、message和call三种类型的事件，仅在卡片中可以调用。
接口定义：postCardAction(component: Object, action: Object): void
接口参数说明：
参数名 | 参数类型 | 必填 | 参数描述 |
|---|---|---|---|
component | Object | 是 | 当前自定义组件的实例，通常传入this。 |
action | Object | 是 | action的具体描述，详情见下表。 |
action参数说明：
Key | Value | 样例描述 |
|---|---|---|
"action" | string | action的类型，支持三种预定义的类型：
|
"bundleName" | string | "router" / "call" 类型时跳转的包名，可选。 |
"moduleName" | string | "router" / "call" 类型时跳转的模块名，可选。 |
"abilityName" | string | "router" / "call" 类型时跳转的UIAbility名，必填。 |
"params" | Object | 当前action携带的额外参数，内容使用JSON格式的键值对形式。"call"类型时需填入参数'method'，且类型需要为string类型，用于触发UIAbility中对应的方法，必填。 |
postCardAction()接口示例代码：
- Button('跳转')
- .width('40%')
- .height('20%')
- .onClick(() => {
- postCardAction(this, {
- 'action': 'router',
- 'bundleName': 'com.example.myapplication',
- 'abilityName': 'EntryAbility',
- 'params': {
- 'message': 'testForRouter' // 自定义要发送的message
- }
- });
- })
- Button('拉至后台')
- .width('40%')
- .height('20%')
- .onClick(() => {
- postCardAction(this, {
- 'action': 'call',
- 'bundleName': 'com.example.myapplication',
- 'abilityName': 'EntryAbility',
- 'params': {
- 'method': 'fun', // 自定义调用的方法名，必填
- 'message': 'testForCall' // 自定义要发送的message
- }
- });
- })
以下介绍通过卡片事件实现的典型开发场景。