@ohos.app.form.FormExtensionAbility (FormExtensionAbility)(系统接口)
FormExtensionAbility为卡片扩展模块,提供卡片创建、销毁、刷新等生命周期回调。
说明:
本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 本模块接口仅可在Stage模型下使用。 当前页面仅包含本模块的系统接口,其他公共接口参见@ohos.app.form.FormExtensionAbility (FormExtensionAbility)。
导入模块
import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';
onShareForm
onShareForm?(formId: string): Record<string, Object>
卡片提供方接收卡片分享的通知接口。
系统接口: 此接口为系统接口。
系统能力:SystemCapability.Ability.Form
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
formId | string | 是 | 卡片标识。 |
返回值:
类型 | 说明 |
---|---|
Record<string, Object> | 卡片要分享的数据,由开发者自行决定传入的键值对。 |
示例:
import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';
export default class MyFormExtensionAbility extends FormExtensionAbility {
onShareForm(formId: string) {
console.log(`FormExtensionAbility onShareForm, formId: ${formId}`);
let wantParams: Record<string, Object> = {
'temperature': '20',
'time': '2022-8-8 09:59',
};
return wantParams;
}
};
onAcquireFormData10+
onAcquireFormData?(formId: string): Record<string, Object>
卡片提供方接收卡片请求自定义数据的通知接口。
系统接口: 此接口为系统接口。
系统能力:SystemCapability.Ability.Form
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
formId | string | 是 | 卡片标识。 |
返回值:
类型 | 说明 |
---|---|
Record<string, Object> | 卡片的自定义数据,由开发者自行决定传入的键值对。 |
示例:
import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';
export default class MyFormExtensionAbility extends FormExtensionAbility {
onAcquireFormData(formId: string) {
console.log(`FormExtensionAbility onAcquireFormData, formId: ${formId}`);
let wantParams: Record<string, Object> = {
'temperature': '20',
'time': '2022-8-8 09:59',
};
return wantParams;
}
};