WIS_EMAP_INPUT

WIS_EMAP_INPUT是一个封装了常用表单组件方法的全局对象,表单控件是以标签上的xtype属性作为控件类型的标识符, 所有带有xtype属性的标签都认为是一个表单控件,以data-name属性为字段name 的标识符
Source:
示例
WIS_EMAP_INPUT.init($form, {root: '/emap'})

配置

(static) WIS_EMAP_INPUT.core

表单控件注册对象
属性:
名称 类型 描述
select Object 单选下拉,基于jqxDropdownList 封装
multi-select2 Object 多选下拉, 基于jqxDropdownList封装
multi-select Object 旧版多选下拉, 基于jqxCombobox封装,不推荐使用
selecttable Object 下拉表格/模糊搜索, 基于jqxCombobox封装
date-ym Object 年月选择框,基于jqxDateTimeInput封装, 默认 yyyy-MM
date-local Object 日期选择框,基于jqxDateTimeInput封装, 默认 yyyy-MM-dd
date-full Object 日期时间选择框,基于jqxDateTimeInput封装, 默认 yyyy-MM-dd HH:mm
date-range Object 日期范围选择, 只能在高级搜索中使用,基于jqxDateTimeInput封装, 默认 yyyy-MM-dd
radiolist Object 单选按钮组
checkboxlist Object 多选按钮组
tree Object 单选下拉树
multi-tree Object 多选下拉树
switcher Object 开关, 基于jqxSwitcheButton封装
buttonlist Object 单选按钮组
multi-buttonlist Object 多选按钮组
textarea Object 计数文本域,基于bhTxtInput封装
number Object 数字文本框,基于jqxNumberInput封装
number-range Object 数字区间,基于jqxNumberInput封装
uploadfile Object 文件上传,基于emapFileUpload封装
uploadsingleimage Object 单图片上传,基于emapSingleFileUpload封装
uploadmuiltimage Object 多图片上传,基于emapFileUpload封装
text Object 文本
div Object div占位
static Object 表单静态字段
Source:

(static) WIS_EMAP_INPUT.validateRules

校验规则库, 配合校验组件使用,emap开发时,可以将规则名称配置在模型配置的【校验类型】一项中, 非emap开发时, 将规则名称配置在字段meta信息的checkType属性上
属性:
名称 类型 描述
required Object 必填校验
double Object 小数
tele/tel Object 电话号码
phone Object 手机号
email/mail Object 邮箱
integer Object 整数
integer+0 Object 非负整数
integer+ Object 正整数
money Object 金额数
score Object 分数
number Object 数字
date Object 日期 YYYY-MM-DD
ipv4 Object ip地址
url Object url地址
onlyNumberSp Object 只能填写数字
onlyLetterSp Object 只能填写英文字母
onlyLetterNumber Object 只能填写数字与英文字母
chinese Object 只能填写中文汉字
chinaId Object 身份证号
chinaIdLoose Object 身份证号宽松匹配
chinaZip Object 中国邮编
qq Object qq
maxLength Object 长度校验
before Object 日期早于联动字段,联动校验配置示例 before@CSRQ,其中CSRQ为联动字段的name
before= Object 日期早于等于联动字段,联动校验配置示例 before=@CSRQ,其中CSRQ为联动字段的name
after Object 日期晚于联动字段,联动校验配置示例 after@CSRQ,其中CSRQ为联动字段的name
after= Object 日期晚于等于联动字段,联动校验配置示例 after=@CSRQ,其中CSRQ为联动字段的name
Source:

方法API

disable(element)

表单控件 disable
参数:
名称 类型 描述
element Object 控件DOM
Source:
示例
WIS_EMAP_INPUT.disable($('[data-name="WID"]'))

enable(element)

表单控件enable
参数:
名称 类型 描述
element Object 控件DOM
Source:
示例
WIS_EMAP_INPUT.enable($('[data-name="WID"]'))

extend(component)

表单控件扩展方法
参数:
名称 类型 描述
component Object 需要注册的表单控件方法对象
Properties
名称 类型 描述
xtype String 表单控件的xtype
init String 表单控件的实例化方法 function默认参数 ele, params
setValue String 表单控件的赋值方法 function默认参数 ele, name, val, root
getValue String 表单控件的取值方法 function默认参数 ele, formData
disable String 表单控件的禁用方法 function默认参数 ele
enable String 表单控件的启用方法 function默认参数 ele
Source:
示例
WIS_EMAP_INPUT.extend({
 xtype: 'xxx',
 init: function(ele, params) {},
 setValue: function(ele, name, val, root) {},
 getValue: function(ele, formData) {},
 disable: function(ele) {},
 enable: function(ele) {}
})

filterCondition(condition) → {Array}

过滤搜索条件,将空值('')去掉,将空白值(@__blank__value)设置为空值('')
参数:
名称 类型 描述
condition Array | String 搜索条件
Source:
返回:
- 过滤后的搜索条件
类型:
Array

formClear(element, valopt, optionsopt)

表单附件清空,如果不传参数val,则清空表单中所有值; 如果传入参数是个数组,则清空该数组中为字段名称的控件值
参数:
名称 类型 属性 描述
element Object 表单容器DOM
val String | Array <optional>
需要清空的字段name,若不传则清空容器内所有的字段
options Object <optional>
表单options参数
Source:
示例
WIS_EMAP_INPUT.formClear($container, ['WID', 'XM', 'XH']) 

formDisable(element, namesopt)

表单disable
参数:
名称 类型 属性 描述
element Object 表单DOM
names String | Array <optional>
需要disable的字段name, 若不传则禁用表单中所有字段
Source:
示例
WIS_EMAP_INPUT.formDisable($container, ['WID', 'XB']) 

formEnable(element, namesopt)

表单enable
参数:
名称 类型 属性 描述
element Object 表单DOM
names String | Array <optional>
需要enable的字段name, 若不传则启用表单中所有字段
Source:
示例
WIS_EMAP_INPUT.formEnable($container, ['WID', 'XB', 'NL'])

formGetValue(element, optionsopt) → {Object}

表单取值
参数:
名称 类型 属性 描述
element Object 表单容器DOM
options Object <optional>
表单options对象
Source:
返回:
表单数据JSON对象
类型:
Object
示例
WIS_EMAP_INPUT.formGetValue($container); 

formSetValue(element, val, options)

表单赋值
参数:
名称 类型 描述
element Object 表单容器
val Object 数据对象 如 {WID: 123}
options Object 表单的options对象
Source:
示例
WIS_EMAP_INPUT.formSetValue($container, {
     'WID': '123456',
     'XB': '1',
     'XB_DISPLAY': '男'
}) 

getConvertCondition(form_data, model, operate_blank_valueopt)

将表单取值数据转化为搜索条件
参数:
名称 类型 属性 默认值 描述
form_data Object 表单数据
model Object 数据模型
operate_blank_value Boolean <optional>
false 是否处理空值(包含两部分 1.去除Value为空的数据 2.将value为@__blank__value的数据value变为"")
Source:
返回:
高级搜索条件

getInputOptions(url, callback)

WIS_EMAP_INPUT.getInputOptions($item.data('url'), function (res) { $item.jqxDropdownList({source: res}); })
参数:
名称 类型 描述
url String 请求地址
callback function 请求成功的回调函数
Source:

getValue(ele, formDataopt) → {Object}

表单项控件取值
参数:
名称 类型 属性 描述
ele Object 表单项控件DOM
formData Object <optional>
用于存放控件_DISPLAY 值的对象,若字段取值是字典,则将_DISPLAY值写到改对象上
Source:
返回:
表单数据JSON对象
类型:
Object
示例
var formData = {};
WIS_EMAP_INPUT.getValue($item, formData); 

init(element, optopt)

表单控件初始化
参数:
名称 类型 属性 描述
element Object 要实例化的控件占位DOM, 可以是单个控件占位或者表单外框
opt Object <optional>
表单控件options 对象
Source:
示例
WIS_EMAP_INPUT.init($container, {});

renderPlaceHolder(item, type, paramsopt) → {string}

根据数据模型项渲染单个字段的placeholder
参数:
名称 类型 属性 描述
item Object 字段数据模型
type String 取值类型,可选值: 'form' 'search' 'grid';
params Object <optional>
其他参数
Properties
名称 类型 属性 默认值 描述
showPlaceholder Boolean <optional>
false 是否添加placeHolder
Source:
返回:
类型:
string
示例
WIS_EMAP_INPUT.renderPlaceHolder({
     xtype: 'text',
     name: 'WID',
     caption: '编号'
})

setValue(element, name, xtype, val, root)

表单控件赋值
参数:
名称 类型 描述
element Object 需要初始化的控件DOM
name String 字段的name
xtype String 控件类型
val Object 数据对象 如 {WID: 123}
root String emap跟路径, 上传控件时必传
Source:
示例
WIS_EMAP_INPUT.setValue($itemElement, 'WID', 'text', {WID: '123456', ''})

{String} [method=] 执行的方法, 默认为fix, 可选值 resize 用于重新定位 placeHolder(ele)

ie9下为文本框/文本域添加placeholder
参数:
名称 类型 描述
ele object 包含文本框的DOM容器 或者 文本框DOM
Source:
示例
WIS_EMAP_INPUT.placeHolder($container);