表单
表单是一个组合组件,即可以直接绑定对象模型,构建基础表单能力,如保存、重置、查询(通过事件编排调用“getFormData”方法)。也可以在空表单中,添加其他可以绑定模型字段的组件,如输入框,下拉框等,以完成数据交互功能。
在标准页面设计界面,从“基本组件”中,拖拽“表单”组件至页面工作区域,如图1。
向页面中拖入一个表单组件,即可弹出元数据表单配置向导页面。您可以在此时绑定一个对象模型(如如何绑定对象模型),或者单击“取消”,再在“数据绑定”下绑定一个模型,还可以在空表单中,设计好表单后,在表单中的某组件(如输入框、下拉框等)上绑定模型字段。
查看组件帮助
将鼠标放在对应的组件上,单击,可查看组件说明。
属性
- 数据绑定:通过建立不同类型的视图模型,将各种数据源和组件的返回值或者属性值进行关联,实现动态数据效果。
- 基本属性
- 弹性布局:是否开启弹性布局。开启后,可以简便、完整、响应式的实现各种页面布局。
- 列数:设置表单的列数。开启弹性布局时,才显示该配置。
- 标签对齐方式:设置标签对齐方式,如左对齐、右对齐和上侧对齐。
- 动态表单数据:请输入JSON格式的选项内容。
- 公共
- 控件名称:当前组件的名称。
- 隐藏:是否隐藏该组件,此方式为静态配置该组件的隐藏。还可以将该组件属性值“隐藏”配置为布尔类型模型字段,在自定义JS代码中来控制模型字段取值,从而设置该组件是否隐藏,这种动态设置优先级是最高的。
- 禁用:是否禁用该组件。
- 只读:值是否只读。
- 样式
- 布局:设置组件的宽度、高度等。
- 字体:设置字体大小、字体样式、颜色等。
- 背景:设置背景颜色、透明度。
- 边框:设置边框颜色、宽度等,单位为px。
- 阴影:设置阴影颜色、模糊、扩散等,单位为px。
- 高级设置
- 样式源码:组件具体样式代码,组件样式设置后,样式代码将自动显示在“样式源码”中。也可以自定义样式代码,对组件进行详细配置。自定义代码支持多行输入,并高亮显示样式参数。
- 样式类:当前组件使用的CSS样式类名,可在CSS代码中进行引用。
如何绑定对象模型
绑定对象模型后,选择对象的字段,即可自动生成具有保存、重置、查询功能的基础表单。
- 配置数据源,在“请选择数据对象”中选择已创建的数据模型,并勾选需要展示的该对象字段,单击“下一步”。
图3 选择数据源
表单及其表单中的子组件绑定的模型字段须是父子关系,中间不能跨级。
- 勾选表单需要显示的按钮,单击“完成”。
图4 选择操作列按钮
图5 表单属性页面
事件
在事件中,显示了组件暴露出来的一些常用事件,供用户实现,来扩展组件的交互。整个页面有加载(on-load)事件,该事件在页面渲染完成后执行,可进行数据初始化操作。更多关于事件的介绍,请参见主要事件说明。
库
在库中,可配置页面需要的依赖库,扩展页面功能。库分为系统预置库和自定义库两种,更多介绍请参见如何引入第三方库。