emapForm

表单
Source:

配置

(static) $.fn.emapForm.defaults

属性:
名称 类型 属性 默认值 描述
data Object 表单数据模型
root String <optional>
emap根路径
readonly Boolean <optional>
false 是否只读
model Sring <optional>
h 表单布局方式 可选值 'h' 水平布局 'v'' 垂直布局 't' 表格布局
cols Int <optional>
3 表单布局列数,只在只读表单和表格表单中生效,可选值 1 2 3
validate Boolean <optional>
true 是否开启表单校验
renderByGroup Boolean <optional>
true 在模型中有分组的情况下,是否按照分组进行渲染
autoColumn Boolean <optional>
true 只读表单和表格表单列宽是否自动补齐
inputWidth Int <optional>
6 水平布局表单,表单控件所占宽度 可选1-12
defaultOptions Object <optional>
控件默认配置参数, 是针对表单中的相同类型控件批量设置的参数,如给所有的单选下拉框统一设置开启搜索功能 $('#form').emapForm({ data: data, defaultOptions: { select: { search: true } } }) 若需要给单独字段设置额外配置参数,请在模型的JSONParam中实现
itemOptions Object <optional>
控制指定字段的参数
showCollapseBtn Boolean <optional>
false 分组表单是否显示 展开收起按钮
showDisableLockedIcon Boolean <optional>
false 表格表单 disable 项 控件右侧是否展示 小锁icon
flexLayout Boolean <optional>
false 只读表单和表格表单是否启用flex布局,**此选项ie9 ie10不兼容**
useNewDropdownTree Boolean <optional>
false 是否使用新的Ztree下拉树来替换现有的下拉树
Source:

方法API

changeLabelColor(paramsopt)

不爱换表单字段label的背景色
参数:
名称 类型 属性 描述
params Object <optional>
json对象, key 为 颜色 可选值: 'primary', 'info', 'success', 'warning', 'danger' , 'normal', value 为要变换的 字段的name 可以为数组
Source:
示例
$Form.emapForm('changeLabelColor', {
     primary: ['WID', 'XH'],
     success: ['XM']
 })

clear()

表单清空
参数:
类型 描述
String | Array 如果不传参数,则清空表单中所有值;如果传入参数是个数组,则清空该数组中为字段名称的控件值
Source:

clearValidateInfo(idopt)

清除字段上的校验出错信息
参数:
名称 类型 属性 描述
id Array | String <optional>
字段id
Source:
示例
$form.emapForm('clearValidateInfo', 'WID');

destroy()

销毁表单
Source:

disableItem(ids)

禁用表单项
参数:
名称 类型 描述
ids String | Array 表单字段的name
Source:

enableItem(ids)

启用表单项
参数:
名称 类型 描述
ids String | Array 表单字段的name
Source:

getModel(sortopt) → {Object}

获取表单模型
参数:
名称 类型 属性 默认值 描述
sort Boolean <optional>
false 是否对表单模型按分组序列化
Source:
返回:
表单模型
类型:
Object

getValue() → {Object}

表单取值
Source:
返回:
包含表单每个字段的值的json对象, key为表单字段的name, value为表单字段的值
类型:
Object

hideItem(ids)

隐藏表单项
参数:
名称 类型 描述
ids String | Array 表单字段的name
Source:

refreshColumns()

刷新只读表单和表格表单的列布局 自动补齐
Source:

reloadValidate()

校验重载
Source:

requireItem(ids)

添加字段的必填校验
参数:
名称 类型 描述
ids String | Array 表单字段的name
Source:

saveUpload(paramopt)

保存表单中的上传组件 (请使用saveUploadSync代替)
参数:
名称 类型 属性 描述
param Object <optional>
保存请求的附带参数
Source:

saveUploadSync(params) → {Object}

异步的保存表单中上传组件的方法, 返回promise对象
参数:
名称 类型 描述
params Object 保存请求附带参数
Source:
返回:
异步方法的Defer对象
类型:
Object

setValue()

表单赋值
参数:
类型 描述
Object 表单数据json对象, key为表单字段的name, value为表单字段的值
Source:

showItem(ids)

显示表单项
参数:
名称 类型 描述
ids String | Array 表单字段的name
Source:

unRequireItem(ids)

取消字段的必填校验
参数:
名称 类型 描述
ids String | Array 表单字段的name
Source: