与数据相关的属性
在前端开发中,我们经常需要从后端获取数据或与后端进行交互,root.js 为组件或扩展标签提供了一些数据属性用于向服务器端发送请求或设置静态数据。数据属性是与数据相关的组件的应用基础,可以说是数据相关组件最关键的属性。比如data
属性是一般用于异步地从数据源加载数据,发送查询请求,服务器端事件用于发送非查询请求,用于与用户交互。
数据属性支持多种数据类型,比较典型的是接口和 PQL,也可以是静态数据。
数据接口
这里仅支持 Json 数据格式的接口,数据接口的书写格式为 method:url # path -> expection
。其中
method
是请求方法,如果是GET
时则可以省略,不区分大小写
url
是 URL 地址,可使用相对或绝对地址(需要后端预先实现中转接口)
path
是返回数据后的解析路径,默认/
,这里支持标准 JsonPath 格式,必须以/
开头,可以省略
expection
用来判断接口返回值是否符合预期,仅服务器端事件支持这个设置,详见服务器端事件接口部分的说明。
示例
FOR 标签的in
属性也是和data
属性一样的逻辑。接口地址支持 Express 字符串语法,可嵌入地址参数或 DOM 操作符。另外,为了方便调用接口,root.js 可以对请求接口的逻辑进行全局设置,以简化接口的调用过程。
PQL 语句
可以在数据属性中直接写 PQL 语句,因为查询逻辑一般比较简单,所以通常表现为一条 SELECT 语句。这里支持所有的 PQL 语句规则,详见 PQL文档。