表单操作 vjsp.Form

表单ready事件

(static).onFormReady(callback)

也可使用 vjsp.page.onFormReady = function(form , parser){}

示例:

vjsp.Form.onFormReady(function(){
    alert('form is ready');
});

参数:

Name	Type	Description
callback	function	回调函数

获取数据前事件

(static).onBeforeLoadData(callback)

也可使用 vjsp.page.onBeforeLoadData = function(exFs,exFields,exData){}

示例:

vjsp.Form.onBeforeLoadData(function(exFs,exFields,exData){
    exFields['exField'] = '额外的数据';
});

参数:

Name	Type	Description
callback	function	回调函数

提交数据前事件

(static).onBeforeSubmit(callback)

也可使用 vjsp.page.onBeforeSubmit = function(exFs,exFields,exData){}

示例:

vjsp.Form.onBeforeSubmit(function(exFs,exFields,exData){
    exFields['exField'] = '额外的数据';
});

参数:

Name	Type	Description
callback	function	回调函数

存储数据前事件

(static).onBeforeSave(callback)

示例:

vjsp.Form.onBeforeSave(function(exFs,exFields,exData){
    exFields['exField'] = '额外的数据';
});

参数:

Name	Type	Description
callback	function	回调函数

表单校验

(static).doValidate() → {Boolean}

示例:

vjsp.Form.doValidate();

返回: 校验结果

Type Boolean

获取初始化数据

(static).getDataCache() → {Object}

示例:

var data = vjsp.Form.getDataCache();

返回: 初始化数据

Type Object

提交表单

(static).submit()

示例:

vjsp.Form.submit();

表单数据存储

(static).save()

save与submit相比，submit为表单的最终提交。而save则是只是存储数据。

示例:

vjsp.Form.save();

获取表单数据

(static).loadData()

json 数据格式

{
    "vjsp_fields_data" : {
        "widgetName" : "widgetValue",
        "widgetName" : "widgetValue"
    }
}

示例:

vjsp.Form.loadData()

执行查询

(static).search()

与loadData的区别是会把表单数据传到后台

示例:

vjsp.Form.search();

提交成功事件

(static).onSubmitSuccess(callback)

示例:

vjsp.Form.onSubmitSuccess(function(){
    alert('submit success');
});

参数:

Name	Type	Description
callback	function	回调函数

存储成功事件

(static).onSaveSuccess(callback)

示例:

vjsp.Form.onSaveSuccess(function(){
    alert('save success');
});

参数:

Name	Type	Description
callback	function	回调函数

载入数据事件

(static).onLoaddata(callback)

示例:

vjsp.Form.onLoaddata(function(){
    alert('onLoaddata');
});

参数:

Name	Type	Description
callback	function	回调函数

查询事件

(static).onSearch(callback)

示例:

vjsp.Form.onSearch(function(){
    alert('onSearch');
});

参数:

Name	Type	Description
callback	function	回调函数

查询完成事件

(static).onAfterSearch(callback)

示例:

vjsp.Form.onAfterSearch(function(){
    alert('onAfterSearch');
});

参数:

Name	Type	Description
callback	function	回调函数

提交事件

(static).onSubmit(callback)

使用代码this.returnValue = false可以阻止提交

示例:

vjsp.Form.onSubmit(function(){
    this.returnValue = false;
});

参数:

Name	Type	Description
callback	function	回调函数

存储数据事件

(static).onSave(callback)

使用代码this.returnValue = false可以阻止存储

示例:

vjsp.Form.onSave(function(){
    this.returnValue = false;
});

参数:

Name	Type	Description
callback	function	回调函数

表单关闭事件

(static).onClose(callback) 使用代码this.returnValue = false可以阻止关闭

示例:

vjsp.Form.onClose(function(){
    this.returnValue = false;
});

参数:

Name	Type	Description
callback	function	回调函数

关闭表单

(static).Close()

示例:

vjsp.Form.close();

设置整个表单只读

(static).setReadonly(rd)

示例:

vjsp.Form.setReadonly(true);

参数:

Name	Type	Description
rd	Boolean	是否只读

获取当前语言

(static).getLangName()→ {String}

示例:

vjsp.Form.getLangName();

返回: 当前语言名称

Type String

设置语言cookie

(static).setLangCookie(lang)

与changeLanguage的区别在于只设置cookie，不实时改变

示例:

vjsp.Form.setLangCookie('zh_CN');

参数:

Name	Type	Description
lang	String	设置语言

改变语言

(static).changeLanguage(lang)

会刷新页面和setLangCookie的区别在于，不仅写cookie，而且会刷新页面，实时更改语言

示例:

vjsp.Form.changeLanguage('en_US');

参数:

Name	Type	Description
lang	String	语言名字

导出EXCEL函数

(static).exportExcel(url,filename,headers,others^opt)

参数:

Name	Type	Attributes	Description
url	String		导出URL
filename	String		导出文件名称
headers	Array｜String		表头映射配置，数组或者数组的JSON字符串
others	Any	optional	其他参数，至多三个 1.分页参数，pageno和pagesize，都是数字，pageno必须在pagesize前面 2.导出数据 ，数组或者数组的JSON字符串 3.eventid， 字符串 4.导出数据和分页参数互斥

表单校验失败事件

(static) onValidateFail(callback)

示例:

vjsp.Form.onValidateFail(function(widget){
    vjsp.alert(widget.get('title') + ' 校验失败!');
    this.returnValue = false;
});

参数:

Name	Type	Description
callback	function	回调函数 回调函数一个参数widget为校验失败控件实例

自定义返回数据处理(主要是针对submit操作的返回)

(static) setResResolver(resResolver)

示例:

// 注册自定义处理函数，默认处理函数失效，下面例子注册提交成功处理，则默认成功处理失效
vjsp.Form.setResResolver({
    success: function(res){
        vjsp.alert('提交成功!');
    }
})

参数:

Name	Type	Description
resResolver	Object	自义定返回处理对象