1# @ohos.application.formBindingData (卡片数据绑定类)
2
3卡片数据绑定模块提供卡片数据绑定的能力。包括FormBindingData对象的创建、相关信息的描述。
4
5> **说明:**
6>
7> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
8> 从API version 9 开始不再维护,建议使用[FormBindingData](js-apis-app-form-formBindingData.md)替代。
9## 导入模块
10
11```ts
12import formBindingData from '@ohos.application.formBindingData';
13```
14
15## FormBindingData
16
17FormBindingData相关描述。
18
19**系统能力:** SystemCapability.Ability.Form
20
21| 名称 | 类型 | 必填 | 说明 |
22| -------- | -------- | -------- | -------- |
23| data | Object | 是 | js卡片要展示的数据。可以是包含若干键值对的Object或者 json 格式的字符串。|
24
25
26## createFormBindingData
27
28createFormBindingData(obj?: Object | string): FormBindingData
29
30创建一个FormBindingData对象。
31
32**系统能力:** SystemCapability.Ability.Form
33
34**参数:**
35
36| 参数名 | 类型           | 必填 | 说明                                                         |
37| ------ | -------------- | ---- | ------------------------------------------------------------ |
38| obj    | Object\|string | 否   | js卡片要展示的数据。可以是包含若干键值对的Object或者 json 格式的字符串。其中图片数据以'formImages'作为标识,内容为图片标识与图片文件描述符的键值对{'formImages': {'key1': fd1, 'key2': fd2}}。 |
39
40
41**返回值:**
42
43| 类型                                | 说明                                    |
44| ----------------------------------- | --------------------------------------- |
45| [FormBindingData](#formbindingdata) | 根据传入数据创建的FormBindingData对象。 |
46
47
48**示例:**
49
50```ts
51import formBindingData from '@ohos.application.formBindingData';
52import fs from '@ohos.file.fs';
53import Base from '@ohos.base';
54
55try {
56  let fd = fs.openSync('/path/to/form.png');
57  let formImagesParam: Record<string, object> = {
58    'image': fd
59  };
60  let createFormBindingDataParam: Record<string, string | Object> = {
61    'name': '21°',
62    'formImages': formImagesParam
63  };
64
65  formBindingData.createFormBindingData(createFormBindingDataParam);
66} catch (error) {
67  console.error(`catch error, error: ${JSON.stringify(error as Base.BusinessError)}`);
68}
69```
70