# 主界面
主界面功能分为四个部分设计器、数据源、监听、元数据
# 设计器
布局可视化功能,从左侧工具箱拖动组件到设计器区域进行布局,设计区域点击选中某个组件,在右侧属性编辑区域编辑组件的属性
具有容器特性的组件内部可以添加下级组件
# 数据源
数据源用于设置数据和远程的交互行为,包括从远程获取数据和向远程提交数据,设计器提供 request 类型数据源实现 http 请求和发送数据,可二次开发增加支持的数据源类型,例如 websocket 或特定行为的 http 请求
# 数据源管理
在数据源界面可进行添加、编辑、删除操作,添加一个数据源需要定义名称和数据源类型
数据源名称可作为一个标识在组件属性编辑表达式里使用
选择数据源类型后出现该类型的相关属性,对数据源进行设置
# 数据源类型
- object
只提供数据定义,实现固定数据
属性
名称 | 说明 | 默认值 |
---|---|---|
数据 | 数据源的数据 | - |
- request
实现基本 http 请求
属性
名称 | 说明 | 默认值 |
---|---|---|
方法 | http 请求类型 GET POST PUT PATCH DELETE | - |
请求地址 | http 请求地址 | - |
请求参数 | GET 类型请求参数 | - |
请求数据 | POST PUT PATCH 类型请求发送的数据 | - |
请求头 | 请求的头部信息 | - |
数据类型 | 请求返回的数据类型 | json |
自动请求 | 界面呈现后自动执行 http 请求 | true |
数据属性 | 定义将请求结果的属性作为数据源的数据 | data |
默认数据 | 数据源不请求或请求无数据时候的默认数据 | - |
异常数据 | http 请求失败,数据源的数据 | - |
方法
名称 | 说明 |
---|---|
load | 执行定义的 http 请求 |
# 监听
监听设置用于管理数据的联动关系,添加一个监听项设置需要监听的属性,选择一个监听管理监听触发后的行为
# 监听项属性
一个监听项具有三个属性
- 监听对象
监听对象定义监听的属性,其中对象 model
datasource
params
refs
中的属性均可用于监听
关于对象
- model
表单数据对象,由内部组件交互操作产生变化的数据,例如:输入文本、选择
- datasource
数据源对象,通过数据源定义的名称获取数据源对象
- params
使用 vjform 呈现视图时,通过 params 属性将外部数据传递进来,这里的 params 就是传递过来的外部数据
当 params 里的属性值被改变时,就会触发监听的属性
- refs
设计器内组件定义的 引用名
,通过引用名获取组件实例,可使用组件的属性和方法
- 深度监听
如果监听的属性值是一个对象,开启深度监听后,对象包含的属性发生变化都会触发监听
- 立即执行
无论属性值是否变化,表单在呈现后会触发一次这个监听
# 监听行为
监听行为是定义在监听项被触发后执行的操作,包含三个属性
条件和行为的定义方式使用属性转换表达式,具体参见属性编辑章节
- 条件
监听项监听的属性被触发后会先验证条件,如果满足定义的条件则执行行为中定义的操作
- 延时
设定在监听被触发后在指定时间间隔后再执行,单位是毫秒
- 行为
监听执行的操作
# 元数据
设计器生成的配置数据,主要包含 fields
datasource
listeners
四个属性的数据,对应使用 vjform
的相应属性