# @ohos.application.formBindingData (卡片数据绑定类)

卡片数据绑定模块提供卡片数据绑定的能力。包括FormBindingData对象的创建、相关信息的描述。  
![](https://media:101784108513994595)  
本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

从API version 9开始废弃，建议使用[formBindingData](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-form-formbindingdata)替代。  

#### 导入模块

```
import { formBindingData } from '@kit.FormKit';
```

#### FormBindingData

FormBindingData提供卡片数据绑定的能力，用于存储卡片需要展示的数据。

系统能力： SystemCapability.Ability.Form  

|名称|类型|只读|可选|说明|
|:---|:-----|:-|:-|:------------------------------------------|
|data|Object|否|否|JS卡片要展示的数据。可以是包含若干键值对的Object或者 json 格式的字符串。|

#### formBindingData.createFormBindingData

createFormBindingData(obj?: Object \| string): FormBindingData

创建一个FormBindingData对象。

系统能力： SystemCapability.Ability.Form

参数：  

|参数名|类型|必填|说明|
|:--|:-------------|:-|:--------------------------------------------------------------------------------------------------------------------------------|
|obj|Object\|string|否|JS卡片要展示的数据。可以是包含若干键值对的Object或者 json 格式的字符串。其中图片数据以'formImages'作为标识，内容为图片标识与图片文件描述符的键值对{'formImages': {'key1': fd1, 'key2': fd2}}。|

返回值：  

|类型|说明|
|:----------------------------------|:--------------------------|
|[FormBindingData](#formbindingdata)|根据传入数据创建的FormBindingData对象。|

示例：

```
import { formBindingData } from '@kit.FormKit';
import { fileIo } from '@kit.CoreFileKit';
import { common } from '@kit.AbilityKit';

@Entry
@Component
struct Index {
  content = this.getUIContext().getHostContext() as common.UIAbilityContext;
  pathDir: string = this.content.filesDir;

  createFormBindingData() {
    let filePath = this.pathDir + "/form.png";
    let fd: number = -1;
    try {
      fd = fileIo.openSync(filePath, fileIo.OpenMode.READ_ONLY).fd;
      let formImagesParam: Record<string, number> = {
        'image': fd
      };
      let createFormBindingDataParam: Record<string, string | Record<string, number>> = {
        'name': '21°',
        'imgSrc': 'image',
        'formImages': formImagesParam
      };
      let formBindingDataObj = formBindingData.createFormBindingData(createFormBindingDataParam);
    } catch (error) {
      console.error(`catch error, code: ${(error as BusinessError).code}, message: ${(error as BusinessError).message}`);
    } finally {
      if (fd !== -1) {
        fileIo.closeSync(fd);
      }
    }
  }

  build() {
    Button('createFormBindingData')
      .onClick((event: ClickEvent) => {
        this.createFormBindingData();
      })
  }
}
```