数据文件

主数据文件定义组件默认展示数据和字段映射，必须位于组件文件夹的config目录下，

main.data.json表示主数据文件，在包含子组件的情况下，子组件拥有独立的数据文件，命名规则为[module_name].data.json

一个完整的数据文件如下所示

{
  "data": [
    {
      "content_1": "产品A",
      "content_2": "项目A"
    },
    {
      "content_1": "产品B",
      "content_2": "项目B"
    }
  ],
  "fields": [
    {
      "name": "content_1",
      "value": "content_1",
      "desc": "映射一"
    },
    {
      "name": "content_2",
      "value": "content_2",
      "desc": "映射二"
    }
  ]
}

参数说明

字段名

说明

值

必填

data

在平台中是组件的初始静态数据

必须为数组

true

fields

字段映射，告诉平台data中有哪些字段

对象数组，每个对象代表一个映射关系，包含三个字段：

name：表示映射哪一个数据，取data中某个字段的key
value：映射到数据的值，取静态数据或其他数据源返回数据的key
desc：映射的描述

true

data

data的数据，在平台右侧"数据"选项卡的"数据接口"中，以"静态数据"存储，可被组件获取，作为展示、回调等的初始数据。

fields

平台中，"字段"、"说明"列分别对应fields的name、desc字段；"映射"列的初始选项对应value字段初始值，后续可选取data中其他字段，添加其他数据源后，可映射返回数据的对应字段。

简单来说，就是改变映射后，value值会更新，再将value的值赋给name，而组件内部使用的数据data和name对应，所以组件内部数据会得到更新。

当"映射"列可以获取到字段时"状态"列为✓，否则为×。

注：若未写明fields参数，那么组件仅可获取data中的字段作为初始数据，无法在平台上通过映射，获取静态数据或其他数据源的字段。

视频教程

此处为语雀视频卡片，点击链接查看：1631791197450.mp4

如遇其他使用问题，可扫描下方二维码，获取更多产品支持~