代码拉取完成,页面将自动刷新
提供静态卡片交互组件,用于静态卡片内部和提供方应用间的交互,当前支持router、message和call三种类型的事件。
说明:
该组件从API Version 10开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
该组件仅可以在静态卡片中使用。
无
支持单个子组件
FormLink(options: FormLinkOptions)
参数:
参数名 | 参数类型 | 必填 | 参数描述 |
---|---|---|---|
options | FormLinkOptions | 是 | 定义卡片信息 |
参数名 | 参数类型 | 必填 | 参数描述 |
---|---|---|---|
action | string | 是 | action的类型,支持三种预定义的类型: - "router":跳转到提供方应用的指定UIAbility。 - "message":自定义消息,触发后会调用提供方FormExtensionAbility的onFormEvent()生命周期回调。 - "call":后台启动提供方应用。触发后会拉起提供方应用的指定UIAbility(仅支持launchType为singleton的UIAbility,即启动模式为单实例的UIAbility),但不会调度到前台。提供方应用需要具备后台运行权限(ohos.permission.KEEP_BACKGROUND_RUNNING)。 说明: 不推荐使用router事件刷新卡片UI。 |
moduleName | string | 否 | "router" / "call" 类型时跳转的模块名,可选。 |
bundleName | string | 否 | "router" / "call" 类型时跳转的包名,可选。 |
abilityName | string | 否 | "router" / "call" 类型时跳转的UIAbility名,可选。 |
uri11+ | string | 否 | "router" / "call" 类型时跳转的UIAbility的统一资源标识符,可选。 |
params | Object | 否 | 当前action携带的额外参数,内容使用JSON格式的键值对形式。"call" 类型时需填入参数'method',且类型需要为string类型,用于触发UIAbility中对应的方法,可选。 说明: 不推荐通过params传递卡片内部的状态变量。 |
支持通用属性
不支持通用事件
@Entry
@Component
struct FormLinkDemo {
build() {
Column() {
Text("这是一个静态卡片").fontSize(20).margin(10)
// router事件用于静态卡片跳转到对应的UIAbility
FormLink({
action: "router",
abilityName: "EntryAbility",
params: {
'message': 'testForRouter' // 自定义要发送的message
}
}) {
Button("router event").width(120)
}.margin(10)
// message事件触发FormExtensionAbility的onFormEvent生命周期
FormLink({
action: "message",
abilityName: "EntryAbility",
params: {
'message': 'messageEvent' // 自定义要发送的message
}
}) {
Button("message event").width(120)
}.margin(10)
// call事件用于触发UIAbility中对应的方法
FormLink({
action: "call",
abilityName: "EntryAbility",
params: {
'method': 'funA', // 在EntryAbility中调用的方法名
'num': 1 // 需要传递的其他参数
}
}) {
Button("call event").width(120)
}.margin(10)
}
.justifyContent(FlexAlign.Center)
.width('100%').height('100%')
}
}
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。