1# @ohos.app.form.FormExtensionAbility (FormExtensionAbility)(系统接口)
2
3FormExtensionAbility为卡片扩展模块，提供卡片创建、销毁、刷新等生命周期回调。
4
5> **说明：**
6>
7> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
8> 本模块接口仅可在Stage模型下使用。
9> 当前页面仅包含本模块的系统接口，其他公共接口参见[@ohos.app.form.FormExtensionAbility (FormExtensionAbility)](./js-apis-app-form-formExtensionAbility.md)。
10
11## 导入模块
12
13```ts
14import { FormExtensionAbility } from '@kit.FormKit';
15```
16
17## onShareForm
18
19onShareForm?(formId: string): Record\<string, Object>
20
21卡片提供方接收卡片分享的通知接口。
22
23**系统能力：** SystemCapability.Ability.Form
24
25**系统接口：** 此接口为系统接口。
26
27**参数：**
28
29| 参数名 | 类型 | 必填 | 说明 |
30| -------- | -------- | -------- | -------- |
31| formId | string | 是 | 卡片标识。 |
32
33**返回值：**
34
35| 类型                   | 说明                                         |
36| ---------------------- | -------------------------------------------- |
37| Record\<string, Object> | 卡片要分享的数据，由开发者自行决定传入的键值对。 |
38
39**示例：**
40
41```ts
42import { FormExtensionAbility } from '@kit.FormKit';
43
44export default class MyFormExtensionAbility extends FormExtensionAbility {
45  onShareForm(formId: string) {
46    console.log(`FormExtensionAbility onShareForm, formId: ${formId}`);
47    let wantParams: Record<string, Object> = {
48      'temperature': '20',
49      'time': '2022-8-8 09:59',
50    };
51    return wantParams;
52  }
53};
54```
55
56## onAcquireFormData<sup>10+<sup>
57
58onAcquireFormData?(formId: string): Record\<string, Object>
59
60卡片提供方接收卡片请求自定义数据的通知接口。
61
62**系统能力：** SystemCapability.Ability.Form
63
64**系统接口：** 此接口为系统接口。
65
66**参数：**
67
68| 参数名 | 类型 | 必填 | 说明 |
69| -------- | -------- | -------- | -------- |
70| formId | string | 是 | 卡片标识。 |
71
72**返回值：**
73
74| 类型                   | 说明                                         |
75| ---------------------- | -------------------------------------------- |
76| Record\<string, Object> | 卡片的自定义数据，由开发者自行决定传入的键值对。 |
77
78**示例：**
79
80```ts
81import { FormExtensionAbility } from '@kit.FormKit';
82
83export default class MyFormExtensionAbility extends FormExtensionAbility {
84  onAcquireFormData(formId: string) {
85    console.log(`FormExtensionAbility onAcquireFormData, formId: ${formId}`);
86    let wantParams: Record<string, Object> = {
87      'temperature': '20',
88      'time': '2022-8-8 09:59',
89    };
90    return wantParams;
91  }
92};
93```
94