卡片数据绑定的能力
卡片数据绑定模块提供卡片数据绑定的能力。包括FormBindingData对象的创建、相关信息的描述。
说明
本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
FormBindingData
FormBindingData相关描述。
系统能力：SystemCapability.Ability.Form
名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
data | Object | 是 | js卡片要展示的数据。可以是包含若干键值对的Object或者 json 格式的字符串。 |
createFormBindingData
createFormBindingData(obj?: Object | string): FormBindingData
创建一个FormBindingData对象。
系统能力：SystemCapability.Ability.Form
参数：
参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
obj | Object|string | 否 | js卡片要展示的数据。可以是包含若干键值对的Object或者 json 格式的字符串。其中图片数据以'formImages'作为标识，内容为图片标识与图片文件描述符的键值对{'formImages': {'key1': fd1, 'key2': fd2}} |
返回值：
类型 | 说明 |
|---|---|
根据传入数据创建的FormBindingData对象。 |
示例：
- import formBindingData from '@ohos.app.form.formBindingData';
- import fs from '@ohos.file.fs';
- try {
- let fd = fs.openSync('/path/to/form.png');
- let obj = {
- 'temperature': '21°',
- 'formImages': { 'image': fd }
- };
- formBindingData.createFormBindingData(obj);
- } catch (error) {
- console.error(`catch error, code: ${error.code}, message: ${error.message}`);
- }