Skip to content

datasource 数据源

数据源配置插件,支持本地数据和远程接口两种数据源类型,用于为页面组件提供动态数据。

数据源类型

类型标识说明
本地数据field手动定义模拟数据,适合静态或简单数据
远程接口remote配置远程 API 地址,运行时动态获取数据

数据源结构

数据源存储在页面 Schema 的 dataSource 字段中,键名为数据源名称,值为配置对象:

json
{
  "dataSource": {
    "userList": {
      "type": "remote",
      "uri": "https://api.example.com/users",
      "method": "GET"
    },
    "config": {
      "type": "field",
      "record": [
        { "title": "页面标题", "theme": "light" }
      ]
    }
  }
}

数据源字段定义

字段类型说明
typestring数据源类型:"remote""field"
uristring远程接口地址(仅 remote 类型)
methodstring请求方法(仅 remote 类型):"GET""POST"

运行时状态

数据源在运行时会被初始化为包含 dataloadingerror 三个字段的状态对象:

json
{
  "userList": {
    "type": "remote",
    "uri": "https://api.example.com/users",
    "method": "GET",
    "data": [{ "id": 1, "name": "张三" }],
    "loading": false,
    "error": null
  }
}
字段类型说明
dataany实际数据(组件访问时返回此字段)
loadingboolean是否正在加载
errorany加载错误信息

数据访问

在组件中通过 this.dataSource.xxx 访问数据源,返回的是 data 字段的值:

json
{
  "type": "JSExpression",
  "value": "this.dataSource.userList"
}