Foxnic-Web 代码生成 (6) —— 配置字段的表单组件

Foxnic-Web 代码生成 (6) —— 配置字段的表单组件
概述

  上一篇中我们讲述了字段配置的通用项,本篇将详细介绍字段的表单编辑器配置。针对不同的表单编辑器,可以指定不同的代码生成参数。默认情况下,代码生成会根据表字段的类型等信息自动匹配一个表单组件。当然,开发人员也可以手动指定每个字段的表单组件类型。

  虽然表单组件是呈现在表单界面的,但是它的设置同样会影响搜索区域对应的条件输入框。搜索区域的条件输入框组件按一定的规则与表单组件对应。本文将逐个介绍表单组件以及它们的代码生成配置项。

  本文中的示例代码均可在 https://gitee.com/LeeFJ/foxnic-samples 项目中找到,本文对照 webfull 项目讲解。

完整示例

  由于,每个组件的配置较多,本篇也不能完全一一列举,提供 Foxnic-Web 项目下有一各种组件支持的完整示例,请大家参考:

https://gitee.com/LeeFJ/foxnic-web/blob/1.7.0.RELEASE/common/generator/src/main/java/org/github/foxnic/web/generator/module/example/CodeExampleConfig.java

单行文本框

  单行文本框是大多数情况下字段的默认组件。通过 view.field(XXX).form().textInput() 方法指定,默认搜索框为单行文本框。它的配置项有:

配置项 说明
defaultText 指定默认文本
多行文本框

  多行文本框通过 view.field(XXX).form().textArea() 方法指定,默认搜索框为单行文本框。它的配置项有:

配置项 说明
defaultText 指定默认文本
height 指定文本框高度
数值输入框

  数值输入框通过 view.field(XXX).form().numberInput() 方法指定,默认搜索框为数值输入框。它的配置项有:

配置项 说明
allowNegative 是否允许负数,默认允许
decimal 指定为小数输入框
integer 指定为整数输入框
defaultValue 默认值
range 数值范围
scale 小数位
step 滚轮步长
按钮组件

按钮组件通过 view.field(XXX).form().button() 方法指定。它的配置项有:

配置项 说明
action 指定默认文本
chooseOrganization 打开组织选择对话框
chooseCompany 打开公司选择对话框
chooseDepartment 打开部门选择对话框
chooseEmployee 打开员工选择对话框
choosePosition 打开岗位对话框
复选框

复选框组件通过 view.field(XXX).form().checkBox() 方法指定,默认搜索框为下拉框。它的配置项有:

配置项 说明
defaultValue 指定默认选中的值
defaultIndex 指定默认选中的序号
enumType 指定选项为枚举类型
dict 指定选项为数据字典
单选框

单选框组件通过 view.field(XXX).form().radioBox() 方法指定,默认搜索框为下拉框。它的配置项有:

配置项 说明
defaultValue 指定默认选中的值
defaultIndex 指定默认选中的序号
enumType 指定选项为枚举类型
dict 指定选项为数据字典
下拉框

下拉框组件通过 view.field(XXX).form().selectBox() 方法指定,默认搜索框为下拉框。它的配置项有:

配置项 说明
defaultValue 指定默认选中的值
defaultIndex 指定默认选中的序号
enumType 指定选项为枚举类型
dict 指定选项为数据字典
fillWith 指定用哪个属性的数据填充下拉框的已选值
filter 是否使用过滤功能
muliti 配置为是否多选
paging 是否分页
size 分页大小
queryApi 指定取数的 API 地址
valueField 设置值列名
textField 设置显示列名
toolbar 是否使用工具栏
日期选择框

日期选择框通过 view.field(XXX).form().dateInput() 方法指定。它的配置项有:

配置项 说明
format 格式,如: yyyy-MM-dd HH:mm:ss , yyyy-MM-dd默认,为自动识别
defaultNow 设置默认值为当前时间
renderAtTop 为避免 iframe 区域太小而被遮挡,可设置改值使其弹出框显示在 iframe 之外 ; 默认 false
Switch组件

Switch 组件通过 view.field(XXX).form().logicField() 方法指定。它的配置项有:

配置项 说明
defaultValue 指定默认文本
on 设置开启(逻辑真)状态下的标签与值
off 设置关闭(逻辑假)状态下的标签与值
文件上传组件

文件上传组件通过 view.field(XXX).form().upload() 方法指定。它的配置项有:

配置项 说明
acceptAllType 允许上传任意类型的文件
acceptAudioType 仅允许上传音频
acceptImageType 仅允许上传图片
acceptSingleFile 仅允许上传单个文件
acceptSingleImage 仅允许上传单个图片
acceptVideoType 仅允许上传视频
acceptMime 允许上传的Mime
acceptExts 允许上传的文件扩展名
buttonLabel 文件浏览按钮的显示文本
displayFileName 是否显示文件名
maxFileCount 最大文件数量
小结

  本节列举了 Foxnic-Web 目前已经支持的全部表单组件。表格中的每个配置方法都包含若干参数,由于篇幅限制不能一一列举每个方法内参数的用法,大家可以按 JavaDoc 提示指定参数值。

相关项目

  https://gitee.com/LeeFJ/foxnic

  https://gitee.com/LeeFJ/foxnic-web

  https://gitee.com/lank/eam

  https://gitee.com/LeeFJ/foxnic-samples

官方文档

  http://foxnicweb.com/docs/doc.html

评论

暂无评论