添加卡片formInfo api 文档

Signed-off-by: Nliweifeng <liweifeng2@huawei.com>
Change-Id: I75723e3d59657da530cc210df0740d8cae14af87

zh-cn/application-dev/reference/apis/js-apis-formInfo.md

+# FormInfo
+
+> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
+> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+
+卡片提供方相关接口。
+
+## 导入模块
+
+```
+import formInfo from '@ohos.application.formInfo';
+```
+
+## 权限
+
+无
+
+## FormInfo
+
+卡片信息
+
+**系统能力：**
+
+SystemCapability.Ability.Form
+
+| 名称        | 读写属性 | 类型                 | 描述                                                         |
+| ----------- | -------- | -------------------- | ------------------------------------------------------------ |
+| bundleName  | 只读     | string               | 表示卡片所属包的包名                           |
+| moduleName  | 只读     | string               | 表示卡片所属模块的模块名                       |
+| abilityName | 只读     | string               | 表示卡片所属的Ability名称                       |
+| name        | 只读     | string               | 表示卡片名称                                 |
+| description | 只读     | string               | 表示卡片描述   |
+| type        | 只读     | [FormType](#enum-formtype)             | 表示卡片类型，当前支持JS卡片 |
+| jsComponentName      | 只读     | string               | 表示js卡片的组件名               |
+| colorMode  | 只读     | [ColorMode](#enum-colormode) | 表示卡片颜色模式                                       |
+| isDefault    | 只读     | boolean      | 表示是否是默认卡片                              |
+| updateEnabled  | 只读     | boolean               | 表示卡片是否使能更新                    |
+| formVisibleNotify  | 只读     | string               | 表示卡片是否使能可见通知            |
+| relatedBundleName | 只读     | string               | 表示卡片所属的相关联包名                   |
+| scheduledUpdateTime        | 只读     | string               | 表示卡片更新时间     |
+| formConfigAbility | 只读     | string               | 表示卡片配置ability   |
+| updateDuration        | 只读     | string             | 表示卡片更新周期 |
+| defaultDimension  | 只读     | number | 表示卡片规格                                       |
+| supportDimensions    | 只读     | Array<number>      | 表示卡片支持的规格                 |
+| customizeData    | 只读     | {[key: string]: [value: string]}      | 表示卡片用户数据          |
+
+## enum FormType
+
+支持的卡片类型
+
+**系统能力：**
+
+SystemCapability.Ability.Form
+
+| 名称        | 值   | 说明         |
+| ----------- | ---- | ------------ |
+| JS      | 1    | 卡片类型为JS   |
+
+## enum ColorMode
+
+卡片支持的颜色模式
+
+**系统能力：**
+
+SystemCapability.Ability.Form
+
+| 名称        | 值   | 说明         |
+| ----------- | ---- | ------------ |
+| MODE_AUTO   | -1    | 自动模式   |
+| MODE_DARK    | 0   | 暗色   |
+| MODE_LIGHT     | 1   | 亮色   |
+
+## FormStateInfo
+
+卡片状态信息
+
+**系统能力：**
+
+SystemCapability.Ability.Form
+
+| 名称        | 读写属性 | 类型                 | 描述                                                         |
+| ----------- | -------- | -------------------- | ------------------------------------------------------------ |
+| formState  | 只读     | [FormState](#enum-formstate)               | 表示卡片状态                           |
+| want  | 只读     | Want               | Want文本内容    |
+
+##  enum FormState
+
+卡片状态
+
+**系统能力：**
+
+SystemCapability.Ability.Form
+
+| 名称        | 值   | 说明         |
+| ----------- | ---- | ------------ |
+| UNKNOWN    | -1    | 未知状态   |
+| DEFAULT     | 0   | 默认状态   |
+| READY      | 1   | 就绪状态   |
+
+##  enum FormParam
+
+卡片参数
+
+**系统能力：**
+
+SystemCapability.Ability.Form
+
+| 名称        | 值   | 说明         |
+| ----------- | ---- | ------------ |
+| IDENTITY_KEY     | "ohos.extra.param.key.form_identity"    | 卡片标识   |
+| DIMENSION_KEY      | "ohos.extra.param.key.form_dimension"  | 卡片规格样式   |
+| NAME_KEY       | "ohos.extra.param.key.form_name"   | 卡片名称   |
+| MODULE_NAME_KEY        | "ohos.extra.param.key.module_name"   | 卡片所属模块名称   |
+| WIDTH_KEY        | "ohos.extra.param.key.form_width"   | 卡片宽度   |
+| HEIGHT_KEY         | "ohos.extra.param.key.form_height"   | 卡片高度   |
+| TEMPORARY_KEY          | "ohos.extra.param.key.form_temporary"   | 临时卡片   |
\ No newline at end of file