[TOC]
## 订阅
### .on("validation")
**描述**:每次验证完一个字段,都会触发`validation`事件,通过该事件可以获取到当前验证字段的验证结果。
**示例**:
~~~javascript
$('#form').on('validation', function(e, current){
var form = this;
// form 中是否所有字段都验证通过
console.log(form.isValid);
// 当前验证字段是否通过
console.log(current.isValid);
// 打印其他属性
console.log(current.element);
console.log(current.value);
console.log(current.msg);
});
~~~
### .on("valid.form")
**描述**:在表单验证通过后触发
**示例**:
~~~javascript
$('#form').on('valid.form', function(e, form){
//do something...
});
~~~
### .on("invalid.form")
**描述**:在表单验证不通过后触发
**示例**:
~~~javascript
$('#form').on('invalid.form', function(e, form, errors){
//do something...
});
~~~
### .on("valid.field")
**描述**:在字段验证通过后触发
**示例**:
~~~javascript
$('#username').on('valid.field', function(e, result){
//do something...
});
~~~
### .on("invalid.field")
**描述**:在字段验证不通过后触发
**示例**:
~~~javascript
$('#username').on('invalid.field', function(e, result){
//do something...
});
~~~
### .on("valid.rule")
**描述**:在规则验证通过后触发
**示例**:
~~~javascript
$('#username').on('valid.rule', function(e, ruleName){
if (ruleName === 'remote') {
//do something...
}
});
~~~
### .on("invalid.rule")
**描述**:在规则验证不通过后触发
**示例**:
~~~javascript
$('#username').on('invalid.rule', function(e, ruleName){
if (ruleName === 'remote') {
//do something...
}
});
~~~
## 发布
### .trigger("validate")
**描述**:触发字段执行验证
**示例**:
~~~javascript
// Verify the selected field.
$('#username').trigger("validate");
// Verify the selected form.
$('#form').trigger("validate");
// Verify the selected area.
$('#area').trigger("validate");
~~~
### .trigger("showmsg", \[type, message\])
**支持**:`v0.8.0+`
**描述**:触发字段提示消息
**示例**:
~~~javascript
// Tips ok message
$("#username").trigger("showmsg", ["ok", "Great name"]);
// Tips error message
$("#username").trigger("showmsg", ["error", "Name is already taken"]);
// Tips general message
$("#username").trigger("showmsg", ["tip", "Others make a good name for you impressed"]);
// Tips tip message has been bound (data-tip)
$("#username").trigger("showmsg", ["tip"]);
// Tips all tip message
$("#form").trigger("showmsg", ["tip"]);
~~~
### .trigger("hidemsg")
**支持**:`v0.8.0+`
**描述**:触发字段隐藏消息
**示例**:
~~~javascript
// Hide field message
$("#username").trigger("hidemsg");
// Hide all messages form the form
$("#form").trigger("hidemsg");
~~~