Foxnic-Web 代码生成 (6) —— 配置字段的表单组件
概述
上一篇中我们讲述了字段配置的通用项，本篇将详细介绍字段的表单编辑器配置。针对不同的表单编辑器，可以指定不同的代码生成参数。默认情况下，代码生成会根据表字段的类型等信息自动匹配一个表单组件。当然，开发人员也可以手动指定每个字段的表单组件类型。
虽然表单组件是呈现在表单界面的，但是它的设置同样会影响搜索区域对应的条件输入框。搜索区域的条件输入框组件按一定的规则与表单组件对应。本文将逐个介绍表单组件以及它们的代码生成配置项。
本文中的示例代码均可在 https://gitee.com/LeeFJ/foxnic-samples 项目中找到，本文对照 webfull 项目讲解。
完整示例
由于，每个组件的配置较多，本篇也不能完全一一列举，提供 Foxnic-Web 项目下有一各种组件支持的完整示例，请大家参考：
单行文本框
单行文本框是大多数情况下字段的默认组件。通过 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/LeeFJ/foxnic-samples
官方文档
