jQuery Validate
El complemento jQuery Validate proporciona potentes funciones de validación para los formularios, haciendo que la validación de formularios en el cliente sea más sencilla. Además, ofrece una gran cantidad de opciones de personalización para satisfacer diversas necesidades de las aplicaciones. El complemento incluye un conjunto útil de métodos de validación, incluida la validación de URL y correo electrónico, y también proporciona una API para escribir métodos de validación personalizados. Todos los métodos incluidos usan inglés como mensaje de error por defecto y ya han sido traducidos a otros 37 idiomas.
Este complemento fue escrito y es mantenido por Jörn Zaefferer, miembro del equipo de jQuery, desarrollador principal del equipo de jQuery UI y mantenedor de QUnit. El complemento comenzó a aparecer en los primeros días de jQuery en 2006 y ha seguido actualizándose hasta hoy. La versión actual es1.14.0。
Visitael sitio oficial de jQuery Validate, descarga la última versión del complemento jQuery Validate.
Importar la librería js (usando el CDN proporcionado por ByteDance)
<script src="https://lf9-cdn-tos.bytecdntp.com/cdn/expire-1-M/jquery/1.12.3/jquery.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/jquery-validation@1.20.0/dist/jquery.validate.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/jquery-validation@1.20.0/dist/localization/messages_zh.min.js"></script>
Reglas de validación predeterminadas
| N.º | Regla | Descripción |
|---|---|---|
| 1 | required:true | Campo obligatorio. |
| 2 | remote:"check.php" | Usa el método ajax para llamar a check.php y validar el valor ingresado. |
| 3 | email:true | Debe ingresar un correo electrónico con formato correcto. |
| 4 | url:true | Debe ingresar una URL con formato correcto. |
| 5 | date:true | Debe ingresar una fecha con formato correcto. La validación de fechas falla en IE6, úsela con precaución. |
| 6 | dateISO:true | Debe ingresar una fecha con formato ISO correcto, por ejemplo: 2009-06-23, 1998/01/22. Solo valida el formato, no la validez. |
| 7 | number:true | Debe ingresar un número válido (negativos, decimales). |
| 8 | digits:true | Debe ingresar un número entero. |
| 9 | creditcard: | Debe ingresar un número de tarjeta de crédito válido. |
| 10 | equalTo:"#field" | El valor ingresado debe ser igual a #field. |
| 11 | accept: | Ingrese una cadena con una extensión válida (extensión de archivo subido). |
| 12 | maxlength:5 | Ingrese una cadena de como máximo 5 caracteres (un carácter chino cuenta como un carácter). |
| 13 | minlength:10 | Ingrese una cadena de al menos 10 caracteres (un carácter chino cuenta como un carácter). |
| 14 | rangelength:[5,10] | Ingrese una cadena cuya longitud esté entre 5 y 10 caracteres (un carácter chino cuenta como un carácter). |
| 15 | range:[5,10] | El valor ingresado debe estar entre 5 y 10. |
| 16 | max:5 | El valor ingresado no puede ser mayor que 5. |
| 17 | min:10 | El valor ingresado no puede ser menor que 10. |
Mensajes predeterminados
messages: {
required: "This field is required.",
remote: "Please fix this field.",
email: "Please enter a valid email address.",
url: "Please enter a valid URL.",
date: "Please enter a valid date.",
dateISO: "Please enter a valid date ( ISO ).",
number: "Please enter a valid number.",
digits: "Please enter only digits.",
creditcard: "Please enter a valid credit card number.",
equalTo: "Please enter the same value again.",
maxlength: $.validator.format( "Please enter no more than {0} characters." ),
minlength: $.validator.format( "Please enter at least {0} characters." ),
rangelength: $.validator.format( "Please enter a value between {0} and {1} characters long." ),
range: $.validator.format( "Please enter a value between {0} and {1}." ),
max: $.validator.format( "Please enter a value less than or equal to {0}." ),
min: $.validator.format( "Please enter a value greater than or equal to {0}." )
}
jQuery Validate proporciona un paquete de mensajes en chino, ubicado en dist/localization/messages_zh.js dentro del paquete de descarga, con el siguiente contenido:
(function( factory ) {
if ( typeof define === "function" && define.amd ) {
define( ["jquery", "../jquery.validate"], factory );
} else {
factory( jQuery );
}
}(function( $ ) {
/*
* Translated default messages for the jQuery validation plugin.
* Locale: ZH (Chinese, 中文 (Zhōngwén), 汉语, 漢語)
*/
$.extend($.validator.messages, {
required: "这是必填字段",
remote: "请修正此字段",
email: "请输入有效的电子邮件地址",
url: "请输入有效的网址",
date: "请输入有效的日期",
dateISO: "请输入有效的日期 (YYYY-MM-DD)",
number: "请输入有效的数字",
digits: "只能输入数字",
creditcard: "请输入有效的信用卡号码",
equalTo: "你的输入不相同",
extension: "请输入有效的后缀",
maxlength: $.validator.format("最多可以输入 {0} 个字符"),
minlength: $.validator.format("最少要输入 {0} 个字符"),
rangelength: $.validator.format("请输入长度在 {0} 到 {1} 之间的字符串"),
range: $.validator.format("请输入范围在 {0} 到 {1} 之间的数值"),
max: $.validator.format("请输入不大于 {0} 的数值"),
min: $.validator.format("请输入不小于 {0} 的数值")
});
}));
Puede incluir este archivo de localización dist/localization/messages_zh.js en la página:
<script src="https://cdn.jsdelivr.net/npm/jquery-validation@1.20.0/dist/localization/messages_zh.min.js"></script>
Forma de uso
1. Escribir las reglas de validación en el control
<script src="https://lf9-cdn-tos.bytecdntp.com/cdn/expire-1-M/jquery/1.12.3/jquery.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/jquery-validation@1.20.0/dist/jquery.validate.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/jquery-validation@1.20.0/dist/localization/messages_zh.min.js"></script>
<script>
$.validator.setDefaults({
submitHandler: function() {
alert("提交事件!");
}
});
$().ready(function() {
$("#commentForm").validate();
});
</script>
<form class="cmxform" id="commentForm" method="get" action="">
<fieldset>
<legend>输入您的名字,邮箱,URL,备注。</legend>
<p>
<label for="cname">Name (必需, 最小两个字母)</label>
<input id="cname" name="name" minlength="2" type="text" required>
</p>
<p>
<label for="cemail">E-Mail (必需)</label>
<input id="cemail" type="email" name="email" required>
</p>
<p>
<label for="curl">URL (可选)</label>
<input id="curl" type="url" name="url">
</p>
<p>
<label for="ccomment">备注 (必需)</label>
<textarea id="ccomment" name="comment" required></textarea>
</p>
<p>
<input class="submit" type="submit" value="Submit">
</p>
</fieldset>
</form>
2. Escribir las reglas de validación en el código js
$().ready(function() {
// 在键盘按下并释放及提交后验证提交表单
$("#signupForm").validate({
rules: {
firstname: "required",
lastname: "required",
username: {
required: true,
minlength: 2
},
password: {
required: true,
minlength: 5
},
confirm_password: {
required: true,
minlength: 5,
equalTo: "#password"
},
email: {
required: true,
email: true
},
topic: {
required: "#newsletter:checked",
minlength: 2
},
agree: "required"
},
messages: {
firstname: "请输入您的名字",
lastname: "请输入您的姓氏",
username: {
required: "请输入用户名",
minlength: "用户名必需由两个字符组成"
},
password: {
required: "请输入密码",
minlength: "密码长度不能小于 5 个字符"
},
confirm_password: {
required: "请输入密码",
minlength: "密码长度不能小于 5 个字符",
equalTo: "两次密码输入不一致"
},
email: "请输入一个正确的邮箱",
agree: "请接受我们的声明",
topic: "请选择两个主题"
}
})
});
En messages, si un control no tiene mensaje, se utilizará el mensaje predeterminado.
<form class="cmxform" id="signupForm" method="get" action="">
<fieldset>
<legend>验证完整的表单</legend>
<p>
<label for="firstname">名字</label>
<input id="firstname" name="firstname" type="text">
</p>
<p>
<label for="lastname">姓氏</label>
<input id="lastname" name="lastname" type="text">
</p>
<p>
<label for="username">用户名</label>
<input id="username" name="username" type="text">
</p>
<p>
<label for="password">密码</label>
<input id="password" name="password" type="password">
</p>
<p>
<label for="confirm_password">验证密码</label>
<input id="confirm_password" name="confirm_password" type="password">
</p>
<p>
<label for="email">Email</label>
<input id="email" name="email" type="email">
</p>
<p>
<label for="agree">请同意我们的声明</label>
<input type="checkbox" class="checkbox" id="agree" name="agree">
</p>
<p>
<label for="newsletter">我乐意接收新信息</label>
<input type="checkbox" class="checkbox" id="newsletter" name="newsletter">
</p>
<fieldset id="newsletter_topics">
<legend>主题 (至少选择两个) - 注意:如果没有勾选“我乐意接收新信息”以下选项会隐藏,但我们这里作为演示让它可见</legend>
<label for="topic_marketflash">
<input type="checkbox" id="topic_marketflash" value="marketflash" name="topic">Marketflash
</label>
<label for="topic_fuzz">
<input type="checkbox" id="topic_fuzz" value="fuzz" name="topic">Latest fuzz
</label>
<label for="topic_digester">
<input type="checkbox" id="topic_digester" value="digester" name="topic">Mailing list digester
</label>
<label for="topic" class="error">Please select at least two topics you'd like to receive.</label>
</fieldset>
<p>
<input class="submit" type="submit" value="提交">
</p>
</fieldset>
</form>
required: trueEl valor es obligatorio.
required: "#aa:checked"Si el valor de la expresión es verdadero, se requiere validación.
required: function(){}Si devuelve verdadero, significa que se requiere validación.
Los dos últimos casos se usan a menudo para elementos en el formulario que deben completarse o no completarse al mismo tiempo.
Métodos comunes y problemas a tener en cuenta
1. Usar otras formas para reemplazar el SUBMIT predeterminado
$().ready(function() {
$("#signupForm").validate({
submitHandler:function(form){
alert("提交事件!");
form.submit();
}
});
});
Usar el método ajax
$(".selector").validate({
submitHandler: function(form)
{
$(form).ajaxSubmit();
}
})
Se pueden configurar los valores predeterminados de validate, de la siguiente manera:
$.validator.setDefaults({
submitHandler: function(form) { alert("提交事件!");form.submit(); }
});
Si desea enviar el formulario, debe usar form.submit() y no $(form).submit().
2. debug, solo validar sin enviar el formulario
Si este parámetro es true, el formulario no se enviará, solo se realizará la validación, lo cual es muy conveniente para depurar.
$().ready(function() {
$("#signupForm").validate({
debug:true
});
});
Si en una página hay varios formularios que desea configurar como debug, use:
$.validator.setDefaults({
debug: true
})
3. ignore: ignorar ciertos elementos y no validarlos
ignore: ".ignore"
4. Cambiar la posición donde se muestra el mensaje de error
errorPlacement:Callback
Indica la posición donde se coloca el error. Por defecto es: error.appendTo(element.parent()); es decir, coloca el mensaje de error después del elemento validado.
errorPlacement: function(error, element) {
error.appendTo(element.parent());
}
Ejemplo
<p>将错误信息放在 label 元素后并使用 span 元素包裹它</p>
<form method="get" class="cmxform" id="form1" action="">
<fieldset>
<legend>Login Form</legend>
<p>
<label for="user">Username</label>
<input id="user" name="user" required minlength="3">
</p>
<p>
<label for="password">Password</label>
<input id="password" type="password" maxlength="12" name="password" required minlength="5">
</p>
<p>
<input class="submit" type="submit" value="Login">
</p>
</fieldset>
</form>
El efecto del código es: en general, el mensaje de error se muestra en
| Parámetro | Tipo | Descripción | Valor predeterminado |
|---|---|---|---|
| errorClass | String | Especifica el nombre de clase CSS del mensaje de error; se puede personalizar el estilo del mensaje de error. | "error" |
| errorElement | String | Qué etiqueta se usa para marcar el error; por defecto es label, se puede cambiar a em. | "label" |
| errorContainer | Selector | Muestra u oculta los mensajes de validación; puede hacer que el atributo del contenedor se muestre automáticamente cuando hay un mensaje de error y se oculte cuando no lo hay. No es de gran utilidad. errorContainer: "#messageBox1, #messageBox2" |
|
| errorLabelContainer | Selector | Coloca todos los mensajes de error en un solo contenedor. | |
| wrapper | String | Qué etiqueta se usa para envolver el errorElement anterior. |
Generalmente estos tres atributos se usan juntos para mostrar todos los mensajes de error en un contenedor y ocultarlo automáticamente cuando no hay mensajes.
errorContainer: "div.error",
errorLabelContainer: $("#signupForm div.error"),
wrapper: "li"
5. Cambiar el estilo del mensaje de error
Configura el estilo del mensaje de error; se puede agregar un ícono. En este sistema ya se ha creado un validation.css, dedicado a mantener los estilos de validación.
input.error { border: 1px solid red; }
label.error {
background:url("./demo/images/unchecked.gif") no-repeat 0px 0px;
padding-left: 16px;
padding-bottom: 2px;
font-weight: bold;
color: #EA5200;
}
label.checked {
background:url("./demo/images/checked.gif") no-repeat 0px 0px;
}
6. Ejecutar una función cuando cada campo pasa la validación
success:String,Callback
La acción posterior a que el elemento a validar pase la validación. Si se le pasa una cadena, se tratará como una clase CSS; también puede recibir una función.
success: function(label) {
// set as text for IE
label.html(" ").addClass("checked");
//label.addClass("valid").text("Ok!")
}
Agrega "valid" al elemento validado, con el estilo definido en CSS <style>label.valid {}</style>.
success: "valid"
7. Modificar la forma de activar la validación
Aunque los siguientes son de tipo boolean, se recomienda no agregarlos a menos que desee cambiarlos a false.
| Forma de activación | Tipo | Descripción | Valor predeterminado |
|---|---|---|---|
| onsubmit | Boolean | Validar al enviar. Si se establece en false, se usarán otros métodos para validar. | true |
| onfocusout | Boolean | Validar al perder el foco (no incluye casillas de verificación / botones de opción). | true |
| onkeyup | Boolean | Validar en el evento keyup. | true |
| onclick | Boolean | Validar al hacer clic en casillas de verificación y botones de opción. | true |
| focusInvalid | Boolean | Después de enviar el formulario, el formulario que no pase la validación (el primero o el que haya recibido el foco antes del envío) recibirá el foco. | true |
| focusCleanup | Boolean | Si es true, cuando el elemento que no pasa la validación recibe el foco, se elimina el mensaje de error. Evite usarlo junto con focusInvalid. | false |
// 重置表单
$().ready(function() {
var validator = $("#signupForm").validate({
submitHandler:function(form){
alert("submitted");
form.submit();
}
});
$("#reset").click(function() {
validator.resetForm();
});
});
8. Validación asíncrona
remote:URL
Realiza la validación mediante ajax. Por defecto envía el valor actualmente validado a la dirección remota. Si necesita enviar otros valores, puede usar la opción data.
remote: "check-email.php"
remote: {
url: "check-email.php", //后台处理程序
type: "post", //数据发送方式
dataType: "json", //接受数据格式
data: { //要传递的数据
username: function() {
return $("#username").val();
}
}
}
La dirección remota solo puede devolver "true" o "false", no puede tener otra salida.
9. Agregar validación personalizada
addMethod:name, method, message
Método de validación personalizado
// 中文字两个字节
jQuery.validator.addMethod("byteRangeLength", function(value, element, param) {
var length = value.length;
for(var i = 0; i < value.length; i++){
if(value.charCodeAt(i) > 127){
length++;
}
}
return this.optional(element) || ( length >= param[0] && length <= param[1] );
}, $.validator.format("请确保输入的值在{0}-{1}个字节之间(一个中文字算2个字节)"));
// 邮政编码验证
jQuery.validator.addMethod("isZipCode", function(value, element) {
var tel = /^[0-9]{6}$/;
return this.optional(element) || (tel.test(value));
}, "请正确填写您的邮政编码");
Nota: Debe agregarse en el archivo additional-methods.js o en el archivo jquery.validate.js. Se recomienda escribirlo generalmente en el archivo additional-methods.js.
Nota: En el archivo messages_cn.js agregue: isZipCode: "solo puede incluir caracteres chinos, letras en inglés, números y guiones bajos". Antes de llamarlo, debe agregar la referencia al archivo additional-methods.js.
10. Validación de radio, checkbox y select
El required de radio significa que debe seleccionarse uno.
<input type="radio" id="gender_male" value="m" name="gender" required /> <input type="radio" id="gender_female" value="f" name="gender"/>
El required de checkbox indica que debe estar marcado.
<input type="checkbox" class="checkbox" id="agree" name="agree" required />
El minlength de checkbox indica el número mínimo de casillas que deben marcarse, maxlength indica el número máximo de casillas marcadas, rangelength:[2,3] indica el rango del número de casillas marcadas.
<input type="checkbox" class="checkbox" id="spam_email" value="email" name="spam[]" required minlength="2" /> <input type="checkbox" class="checkbox" id="spam_phone" value="phone" name="spam[]" /> <input type="checkbox" class="checkbox" id="spam_mail" value="mail" name="spam[]" />
El required de select indica que el value seleccionado no puede estar vacío.
<select id="jungle" name="jungle" title="Please select something!" required>
<option value=""></option>
<option value="1">Buga</option>
<option value="2">Baga</option>
<option value="3">Oi</option>
</select>
El minlength de select indica el número mínimo de elementos seleccionados (select de selección múltiple), maxlength indica el número máximo de elementos seleccionados, rangelength:[2,3] indica el rango del número de elementos seleccionados.
<select id="fruit" name="fruit" title="Please select at least two fruits" class="{required:true, minlength:2}" multiple="multiple">
<option value="b">Banana</option>
<option value="a">Apple</option>
<option value="p">Peach</option>
<option value="t">Turtle</option>
</select>
API en chino de jQuery.validate
| Nombre | Tipo de retorno | Descripción |
|---|---|---|
| validate(options) | Validator | Valida el FORM seleccionado. |
| valid() | Boolean | Comprueba si pasa la validación. |
| rules() | Options | Devuelve las reglas de validación del elemento. |
| rules("add",rules) | Options | Añade reglas de validación. |
| rules("remove",rules) | Options | Elimina reglas de validación. |
| removeAttrs(attributes) | Options | Elimina atributos especiales y los devuelve. |
| Selectores personalizados | ||
| :blank | Validator | Filtro sin valor. |
| :filled | Array <Element> | Filtro con valor. |
| :unchecked | Array <Element> | Filtro de elementos no seleccionados. |
| Utilidades | ||
| jQuery.format(template,argument,argumentN...) | String | Reemplaza {n} en la plantilla con parámetros. |
Validator
El método validate devuelve un objeto Validator. El objeto Validator tiene muchos métodos que se pueden usar para activar el programa de validación o cambiar el contenido del form. A continuación se enumeran algunos métodos de uso común.
| Nombre | Tipo de retorno | Descripción |
|---|---|---|
| form() | Boolean | Valida el form y devuelve si es exitoso o falla. |
| element(element) | Boolean | Valida un solo elemento y devuelve si es exitoso o falla. |
| resetForm() | undefined | Restaura el FORM previamente validado a su estado original antes de la validación. |
| showErrors(errors) | undefined | Muestra mensajes de error específicos. |
| Funciones de Validator | ||
| setDefaults(defaults) | undefined | Cambia la configuración predeterminada. |
| addMethod(name,method,message) | undefined | Añade un nuevo método de validación. Debe incluir un nombre único, un método JAVASCRIPT y un mensaje predeterminado. |
| addClassRules(name,rules) | undefined | Añade tipos de validación combinados; es útil cuando se usan varios métodos de validación en una clase. |
| addClassRules(rules) | undefined | Añade tipos de validación combinados; es útil cuando se usan varios métodos de validación en una clase. Este añade varios métodos de validación a la vez. |
Métodos de validación integrados
| Nombre | Tipo de retorno | Descripción |
|---|---|---|
| required() | Boolean | Valida que el elemento sea obligatorio. |
| required(dependency-expression) | Boolean | Elemento obligatorio que depende del resultado de una expresión. |
| required(dependency-callback) | Boolean | Elemento obligatorio que depende del resultado de una función de retorno de llamada (callback). |
| remote(url) | Boolean | Solicita validación remota. La url suele ser un método de llamada remota. |
| minlength(length) | Boolean | Establece la longitud mínima. |
| maxlength(length) | Boolean | Establece la longitud máxima. |
| rangelength(range) | Boolean | Establece un rango de longitud [min,max]. |
| min(value) | Boolean | Establece el valor mínimo. |
| max(value) | Boolean | Establece el valor máximo. |
| email() | Boolean | Valida el formato de correo electrónico. |
| range(range) | Boolean | Establece un rango de valores. |
| url() | Boolean | Valida el formato de URL. |
| date() | Boolean | Valida el formato de fecha (similar al formato 30/30/2008; solo valida el formato, no la exactitud de la fecha). |
| dateISO() | Boolean | Valida el formato de fecha tipo ISO. |
| dateDE() | Boolean | Valida el formato de fecha alemán (29.04.1994 o 1.1.2006). |
| number() | Boolean | Valida números decimales (incluidos los que tienen decimales). |
| digits() | Boolean | Valida números enteros. |
| creditcard() | Boolean | Valida números de tarjeta de crédito. |
| accept(extension) | Boolean | Valida cadenas con el mismo sufijo. |
| equalTo(other) | Boolean | Valida si el contenido de dos campos de entrada es igual. |
| phoneUS() | Boolean | Valida números de teléfono de estilo estadounidense. |
Opciones de validate()
| Descripción | Código |
|---|---|
| debug: activa el modo de depuración (el formulario no se envía). |
$(".selector").validate
({
debug:true
})
|
| Establece la depuración como valor predeterminado. |
$.validator.setDefaults({
debug:true
})
|
| submitHandler: función que se ejecuta después de superar la validación; debe incluir la función de envío del formulario, de lo contrario el formulario no se enviará. |
$(".selector").validate({
submitHandler:function(form) {
$(form).ajaxSubmit();
}
})
|
| ignore: no valida ciertos elementos. |
$("#myform").validate({
ignore:".ignore"
})
|
| rules: reglas personalizadas en formato key:value; key es el elemento a validar, value puede ser una cadena o un objeto. |
$(".selector").validate({
rules:{
name:"required",
email:{
required:true,
email:true
}
}
})
|
| messages: mensajes personalizados en formato key:value; key es el elemento a validar, value puede ser una cadena o una función. |
$(".selector").validate({
rules:{
name:"required",
email:{
required:true,
email:true
}
},
messages:{
name:"Name不能为空",
email:{
required:"E-mail不能为空",
email:"E-mail地址不正确"
}
}
})
|
| groups: validación de un grupo de elementos con un único mensaje de error; use errorPlacement para controlar dónde se coloca el mensaje de error. |
$("#myform").validate({
groups:{
username:"fname
lname"
},
errorPlacement:function(error,element) {
if (element.attr("name") == "fname" || element.attr("name") == "lname")
error.insertAfter("#lastname");
else
error.insertAfter(element);
},
debug:true
})
|
| OnSubmit: tipo Boolean, predeterminado true, especifica si se valida al enviar. |
$(".selector").validate({
onsubmit:false
})
|
| onfocusout: tipo Boolean, predeterminado true, especifica si se valida al obtener el foco. |
$(".selector").validate({
onfocusout:false
})
|
| onkeyup: tipo Boolean, predeterminado true, especifica si se valida al presionar teclas del teclado. |
$(".selector").validate({
onkeyup:false
})
|
| onclick: tipo Boolean, predeterminado true, especifica si se valida al hacer clic con el mouse (generalmente valida checkbox, radiobox). |
$(".selector").validate({
onclick:false
})
|
| focusInvalid: tipo Boolean, predeterminado true. Después de enviar el formulario, el formulario que no superó la validación (el primero o el que obtuvo el foco antes del envío) recibirá el foco. |
$(".selector").validate({
focusInvalid:false
})
|
| focusCleanup: tipo Boolean, predeterminado false. Cuando un elemento que no superó la validación obtiene el foco, se elimina el mensaje de error (evite usarlo junto con focusInvalid). |
$(".selector").validate({
focusCleanup:true
})
|
| errorClass: tipo String, predeterminado "error". Especifica el nombre de clase css de los mensajes de error; puede personalizar el estilo de los mensajes de error. |
$(".selector").validate({
errorClass:"invalid"
})
|
| errorElement: tipo String, predeterminado "label". Especifica qué etiqueta se usa para marcar el error. |
$(".selector").validate
errorElement:"em"
})
|
| wrapper: tipo String, especifica qué etiqueta se usa para envolver el errorElement anterior. |
$(".selector").validate({
wrapper:"li"
})
|
| errorLabelContainer: tipo Selector, coloca los mensajes de error de forma unificada en un contenedor. |
$("#myform").validate({
errorLabelContainer:"#messageBox",
wrapper:"li",
submitHandler:function() {
alert("Submitted!")
}
})
|
| showErrors: acepta una función; puede mostrar cuántos elementos no superaron la validación en total. |
$(".selector").validate({
showErrors:function(errorMap,errorList) {
$("#summary").html("Your form contains " + this.numberOfInvalids() + " errors,see details below.");
this.defaultShowErrors();
}
})
|
| errorPlacement: acepta una función; permite personalizar dónde colocar los errores. |
$("#myform").validate({
errorPlacement:function(error,element) {
error.appendTo(element.parent("td").next("td"));
},
debug:true
})
|
| success: acción después de que el elemento pase la validación; si se le pasa una cadena, se tratará como una clase css; también se le puede pasar una función. |
$("#myform").validate({
success:"valid",
submitHandler:function() {
alert("Submitted!")
}
})
|
| highlight: puede añadir efectos, parpadeo, etc., a los elementos que no superaron la validación. |
Método addMethod(name,method,message)
El parámetro name es el nombre del método que se añade.
El parámetro method es una función que recibe tres parámetros (value,element,param).
value es el valor del elemento, element es el propio elemento y param es el parámetro.
Podemos usar addMethod para añadir métodos de validación además de los métodos Validation integrados. Por ejemplo, si hay un campo que solo puede contener una letra en el rango de a-f, la sintaxis es la siguiente:
$.validator.addMethod("af",function(value,element,params){
if(value.length>1){
return false;
}
if(value>=params[0] && value<=params[1]){
return true;
}else{
return false;
}
},"必须是一个字母,且a-f");
Si un campo del formulario tiene name="username", entonces en rules se escribe:
username:{
af:["a","f"]
}
El primer parámetro de addMethod es el nombre del método de validación añadido; en este caso es af.
El tercer parámetro de addMethod es el mensaje de error personalizado; aquí el mensaje es: "debe ser una letra, y de a-f".
El segundo parámetro de addMethod es una función; este es más importante, determina la sintaxis al usar este método de validación.
Si solo hay un parámetro, se escribe directamente, por ejemplo af:"a", entonces a es el único parámetro; si hay varios parámetros, se escriben dentro de [] separados por comas.
Modo meta String
$("#myform").validate({
meta:"validate",
submitHandler:function() {
alert("Submitted!") }
})
<script type="text/javascript"
src="js/jquery.metadata.js.html"></script>
<script type="text/javascript"
src="js/jquery.validate.js.html"></script>
<form id="myform">
<input type="text"
name="email" class="{validate:{ required:true,email:true }}" />
<input type="submit"
value="Submit" />
</form>