Form
覆盖默认值
$.fn.form.defaults.
form提供不同的方法执行操作表单字段例如ajax submit,loader,clear,等等..当提交表单的时候,'validate'将调用验证表单是否合法.
Usage
创建简单的HTML form,构造这个通常会使用id,action和method的值.
使表单成为ajax提交的form
执行提交动作
处理 submit 响应
提交一个ajax的form非常简单,当提交结束后用户可以得到响应数据,注意这个响应数据是来自服务器端的原始数据,响应数据的一个解析动作是需要得到的是正确的数据.
例如:响应数据假设为json,一个标准的响应数据例如下面这个
:
现在处理json字符串在'success'回调函数中.
Properties
| Name | Type | Description | Default |
|---|---|---|---|
| url | string | form的action的URL提交地址 | null |
Events
| Name | Parameters | Description |
|---|---|---|
| onSubmit | none | form提交之前触发,该方法返回false将阻止submit动作. |
| success | data | 当form提交成功之后触发. |
| onBeforeLoad | param | 在请求加载数据之前触发.该方法返回false将取消这个动作. |
| onLoadSuccess | data | 当form数据成功加载之后触发. |
| onLoadError | none | 当在加载数据的时候出现一些异常的时候触发. |
Methods
| Name | Parameter | Description |
|---|---|---|
| submit | options | 执行submit动作, 这个 options参数是一个对象包含一下属性: url: 这个提交动作的URL地址 onSubmit: 在提交之前的回调函数 success: 提交成功之后的回调函数 下面的示例展示如何提交一个合法form和避免重复提交form $.messager.progress(); // 显示一个进度条
$('#ff').form('submit', {
url: ...,
onSubmit: function(){
var isValid = $(this).form('validate');
if (!isValid){
$.messager.progress('close'); // 当form不合法的时候隐藏工具条
}
return isValid; // 返回false将停止form提交
},
success: function(){
$.messager.progress('close'); // 当成功提交之后隐藏进度条
}
});
|
| load | data | 加载记录填充form. 这个 data 参数可以是一个string或者是一个object类型,
当是string类型的时候将请求远程服务器端数据,其他(例如:object类型)行为定义为加载本地记录.
示例代码: $('#ff').form('load','get_data.php'); // 从URL加载
$('#ff').form('load',{//加载本地记录
name:'name2',
email:'mymail@gmail.com',
subject:'subject2',
message:'message2',
language:5
});
|
| clear | none | 清空form数据 |
| validate | none | 做form字段验证,返回true表示所有字段合法,这个方法使用了validatebox插件plugin. |