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" }
]
}
}
}数据源字段定义
| 字段 | 类型 | 说明 |
|---|---|---|
type | string | 数据源类型:"remote" 或 "field" |
uri | string | 远程接口地址(仅 remote 类型) |
method | string | 请求方法(仅 remote 类型):"GET"、"POST" 等 |
运行时状态
数据源在运行时会被初始化为包含 data、loading、error 三个字段的状态对象:
json
{
"userList": {
"type": "remote",
"uri": "https://api.example.com/users",
"method": "GET",
"data": [{ "id": 1, "name": "张三" }],
"loading": false,
"error": null
}
}| 字段 | 类型 | 说明 |
|---|---|---|
data | any | 实际数据(组件访问时返回此字段) |
loading | boolean | 是否正在加载 |
error | any | 加载错误信息 |
数据访问
在组件中通过 this.dataSource.xxx 访问数据源,返回的是 data 字段的值:
json
{
"type": "JSExpression",
"value": "this.dataSource.userList"
}