jQuery Validate
Le plugin jQuery Validate fournit de puissantes fonctionnalités de validation pour les formulaires, ce qui simplifie la validation des formulaires côté client tout en offrant un grand nombre d'options de personnalisation pour répondre à divers besoins applicatifs. Le plugin regroupe un ensemble de méthodes de validation utiles, notamment la validation d'URL et d'e-mail, et fournit également une API pour écrire des méthodes définies par l'utilisateur. Toutes les méthodes intégrées utilisent l'anglais comme message d'erreur par défaut, et ont été traduites dans 37 autres langues.
Ce plugin a été écrit et maintenu par Jörn Zaefferer, membre de l'équipe jQuery, développeur principal de l'équipe jQuery UI et mainteneur de QUnit. Le plugin est apparu pour la première fois aux débuts de jQuery en 2006 et a été mis à jour depuis. La version actuelle est1.14.0。
Visitezle site officiel de jQuery Validatepour télécharger la dernière version du plugin jQuery Validate.
Importer la bibliothèque js (en utilisant le CDN fourni par 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>
Règles de validation par défaut
| Non. | Règle | Description |
|---|---|---|
| 1 | required:true | Le champ est obligatoire. |
| 2 | remote:"check.php" | Utilisez la méthode ajax pour appeler check.php afin de valider la valeur saisie. |
| 3 | email:true | Vous devez saisir une adresse e-mail au format correct. |
| 4 | url:true | Vous devez saisir une URL au format correct. |
| 5 | date:true | Vous devez saisir une date au format correct. La validation de date échoue dans IE6 ; à utiliser avec prudence. |
| 6 | dateISO:true | Vous devez saisir une date au format ISO correct, par exemple : 2009-06-23, 1998/01/22. Ne valide que le format, pas la validité. |
| 7 | number:true | Vous devez saisir un nombre valide (nombres négatifs, nombres décimaux). |
| 8 | digits:true | Vous devez saisir un nombre entier. |
| 9 | creditcard: | Vous devez saisir un numéro de carte de crédit valide. |
| 10 | equalTo:"#field" | La valeur saisie doit être identique à #field. |
| 11 | accept: | Vous devez saisir une chaîne avec un nom d'extension valide (l'extension du fichier téléversé). |
| 12 | maxlength:5 | Saisissez une chaîne d'une longueur maximale de 5 (les caractères chinois comptent comme un seul caractère). |
| 13 | minlength:10 | Saisissez une chaîne d'une longueur minimale de 10 (les caractères chinois comptent comme un seul caractère). |
| 14 | rangelength:[5,10] | Saisissez une chaîne d'une longueur comprise entre 5 et 10 (les caractères chinois comptent comme un seul caractère). |
| 15 | range:[5,10] | La valeur saisie doit être comprise entre 5 et 10. |
| 16 | max:5 | La valeur saisie ne peut pas être supérieure à 5. |
| 17 | min:10 | La valeur saisie ne peut pas être inférieure à 10. |
Messages par défaut
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 fournit un paquet de messages en chinois, situé dans dist/localization/messages_zh.js dans le paquet de téléchargement, avec le contenu suivant :
(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} 的数值")
});
}));
Vous pouvez inclure ce fichier de messages de localisation, dist/localization/messages_zh.js, dans la page :
<script src="https://cdn.jsdelivr.net/npm/jquery-validation@1.20.0/dist/localization/messages_zh.min.js"></script>
Utilisation
1. Écrire les règles de validation dans le contrôle
<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. Écrire les règles de validation dans le code 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: "请选择两个主题"
}
})
});
Pour la partie messages, si un contrôle n'a pas de message, le message par défaut sera utilisé.
<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: trueLa valeur est requise.
required: "#aa:checked"Si l'expression est vraie, la validation est requise.
required: function(){}Si elle renvoie true, la validation est requise.
Les deux derniers sont couramment utilisés pour les éléments d'un formulaire qui doivent être remplis ou laissés vides ensemble.
Méthodes courantes et points à noter
1. Utiliser d'autres moyens pour remplacer le SUBMIT par défaut
$().ready(function() {
$("#signupForm").validate({
submitHandler:function(form){
alert("提交事件!");
form.submit();
}
});
});
Utiliser l'approche ajax
$(".selector").validate({
submitHandler: function(form)
{
$(form).ajaxSubmit();
}
})
Vous pouvez définir les valeurs par défaut pour validate, comme suit :
$.validator.setDefaults({
submitHandler: function(form) { alert("提交事件!");form.submit(); }
});
Si vous voulez soumettre le formulaire, vous devez utiliser form.submit(), et non $(form).submit().
2. debug, valider uniquement et ne pas soumettre le formulaire
Si ce paramètre est true, le formulaire ne sera pas soumis ; seule la validation est effectuée, ce qui est très pratique pour le débogage.
$().ready(function() {
$("#signupForm").validate({
debug:true
});
});
S'il y a plusieurs formulaires sur une page qui doivent tous être définis sur debug, utilisez :
$.validator.setDefaults({
debug: true
})
3. ignore : ignorer certains éléments sans validation
ignore: ".ignore"
4. Changer la position où les messages d'erreur sont affichés
errorPlacement:Callback
Spécifiez la position où les erreurs sont placées. La valeur par défaut est : error.appendTo(element.parent()); c'est-à-dire que le message d'erreur est placé après l'élément en cours de validation.
errorPlacement: function(error, element) {
error.appendTo(element.parent());
}
Exemple
<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>
L'objectif du code est : normalement, le message d'erreur est affiché dans
| Paramètre | Type | Description | Valeur par défaut |
|---|---|---|---|
| errorClass | String | Spécifiez le nom de classe CSS pour les messages d'erreur ; vous pouvez personnaliser le style des messages d'erreur. | "error" |
| errorElement | String | La balise utilisée pour marquer les erreurs ; la valeur par défaut est label, et elle peut être remplacée par em. | "label" |
| errorContainer | Sélecteur | Afficher ou masquer les informations de validation. Il peut modifier automatiquement l'attribut container pour l'afficher lorsqu'un message d'erreur apparaît et le masquer lorsqu'il n'y a pas d'erreur ; cela a peu d'utilité. errorContainer: "#messageBox1, #messageBox2" |
|
| errorLabel | Sélecteur | Regroupez tous les messages d'erreur dans un seul conteneur. | |
| wrapper | String | Indiquez quelle balise utiliser pour envelopper l'errorElement ci-dessus. |
Généralement, ces trois attributs sont utilisés ensemble pour afficher tous les messages d'erreur dans un seul conteneur, et les masquer automatiquement lorsqu'il n'y a aucun message.
errorContainer: "div.error",
errorLabelContainer: $("#signupForm div.error"),
wrapper: "li"
5. Modifier le style d'affichage des messages d'erreur
Définissez le style des messages d'erreur ; des icônes peuvent être ajoutées à l'affichage. Dans ce système, un fichier validation.css a été créé spécialement pour maintenir les styles des fichiers de validation.
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. Exécuter une fonction après la validation de chaque champ
success:String,Callback
L'action à exécuter après qu'un élément à valider a passé la validation. Si une chaîne est fournie, elle sera traitée comme une classe CSS ; une fonction peut également être fournie.
success: function(label) {
// set as text for IE
label.html(" ").addClass("checked");
//label.addClass("valid").text("Ok!")
}
Ajoutez "valid" à l'élément validé, et définissez le style en CSS comme <style>label.valid {}</style>.
success: "valid"
7. Modifier le mode de déclenchement de la validation
Les éléments suivants sont de type booléen, mais il est recommandé de ne pas les ajouter à la légère, sauf si vous devez les modifier.
| Méthode de déclenchement | Type | Description | Valeur par défaut |
|---|---|---|---|
| onsubmit | Boolean | Valider lors de la soumission. Définir sur false pour utiliser d'autres méthodes de validation. | vrai |
| onfocusout | Boolean | Valider lors de la perte de focus (à l'exclusion des cases à cocher/boutons radio). | vrai |
| onkeyup | Boolean | Valider sur keyup. | vrai |
| onclick | Boolean | Valider lors du clic sur les cases à cocher et les boutons radio. | vrai |
| focusInvalid | Boolean | Après la soumission du formulaire, le formulaire qui échoue à la validation (le premier ou le formulaire invalide qui a obtenu le focus avant la soumission) recevra le focus. | vrai |
| focusCleanup | Boolean | Si true, lorsqu'un élément qui échoue à la validation obtient le focus, le message d'erreur est supprimé. Évitez de l'utiliser avec focusInvalid. | false |
// 重置表单
$().ready(function() {
var validator = $("#signupForm").validate({
submitHandler:function(form){
alert("submitted");
form.submit();
}
});
$("#reset").click(function() {
validator.resetForm();
});
});
8. Validation asynchrone
remote:URL
Utilisez ajax pour la validation. Par défaut, la valeur actuellement validée est soumise à l'adresse distante. Si vous devez soumettre d'autres valeurs, vous pouvez utiliser l'option data.
remote: "check-email.php"
remote: {
url: "check-email.php", //后台处理程序
type: "post", //数据发送方式
dataType: "json", //接受数据格式
data: { //要传递的数据
username: function() {
return $("#username").val();
}
}
}
L'adresse distante ne peut renvoyer que "true" ou "false", et ne peut avoir aucune autre sortie.
9. Ajouter une validation personnalisée
addMethod:name, method, message
Méthode de validation personnalisée
// 中文字两个字节
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));
}, "请正确填写您的邮政编码");
Remarque: Il faut l'ajouter dans le fichier additional-methods.js ou dans le fichier jquery.validate.js. Il est recommandé de l'écrire généralement dans le fichier additional-methods.js.
Remarque: Ajoutez-le dans le fichier messages_cn.js : isZipCode: "ne peut inclure que des caractères chinois, des lettres anglaises, des chiffres et des traits de soulignement". Avant l'appel, ajoutez une référence au fichier additional-methods.js.
10. Validation des boutons radio, cases à cocher et listes déroulantes
Pour les boutons radio, required signifie qu'une option doit être sélectionnée.
<input type="radio" id="gender_male" value="m" name="gender" required /> <input type="radio" id="gender_female" value="f" name="gender"/>
Pour les cases à cocher, required signifie qu'une case doit être cochée.
<input type="checkbox" class="checkbox" id="agree" name="agree" required />
Pour les cases à cocher, minlength indique le nombre minimum de sélections requises, maxlength indique le nombre maximum de sélections, et rangelength:[2,3] indique une plage pour le nombre de sélections.
<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[]" />
Pour les listes déroulantes, required signifie que la valeur sélectionnée ne peut pas être vide.
<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>
Pour les listes déroulantes, minlength indique le nombre minimum d'éléments sélectionnés (pour les listes à sélection multiple), maxlength indique le nombre maximum d'éléments sélectionnés, et rangelength:[2,3] indique une plage pour le nombre d'éléments sélectionnés.
<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 chinoise de jQuery.validate
| Name | Type de retour | Description |
|---|---|---|
| validate(options) | Validateur | Valider le formulaire sélectionné. |
| valid() | Boolean | Vérifier si la validation a réussi. |
| rules() | Options | Retourner les règles de validation pour un élément. |
| rules("add",rules) | Options | Ajouter des règles de validation. |
| rules("remove",rules) | Options | Supprimer des règles de validation. |
| removeAttrs(attributes) | Options | Supprimer les attributs spéciaux et les renvoyer. |
| Sélecteurs personnalisés | ||
| :blank | Validateur | Filtre pour les éléments sans valeur. |
| :filled | Array <Element> | Filtre pour les éléments avec une valeur. |
| :unchecked | Array <Element> | Filtre pour les éléments qui ne sont pas sélectionnés. |
| Outils utilitaires | ||
| jQuery.format(template,argument,argumentN...) | String | Remplacez {n} dans le modèle par les arguments. |
Validateur
La méthode validate renvoie un objet Validator. L'objet Validator possède de nombreuses méthodes qui peuvent être utilisées pour déclencher la validation ou modifier le contenu du formulaire. Voici quelques méthodes couramment utilisées.
| Name | Type de retour | Description |
|---|---|---|
| form() | Boolean | Valider le formulaire et renvoyer un succès ou un échec. |
| element(element) | Boolean | Valider un seul élément pour un succès ou un échec. |
| resetForm() | undefined | Restaurer le formulaire précédemment validé dans son état d'origine avant la validation. |
| showErrors(errors) | undefined | Afficher un message d'erreur spécifique. |
| Fonctions du Validator | ||
| setDefaults(defaults) | undefined | Modifier les paramètres par défaut. |
| addMethod(name,method,message) | undefined | Ajoute une nouvelle méthode de validation. Elle doit inclure un nom unique, une méthode JavaScript et un message par défaut. |
| addClassRules(name,rules) | undefined | Ajoute un type de validation composite, utile lorsqu'on utilise plusieurs méthodes de validation dans une même classe. |
| addClassRules(rules) | undefined | Ajoute des types de validation composites, utile lorsqu'on utilise plusieurs méthodes de validation dans une même classe. Celui-ci ajoute plusieurs méthodes de validation en même temps. |
Méthodes de validation intégrées
| Name | Type de retour | Description |
|---|---|---|
| required() | Boolean | Validation requise pour un élément. |
| required(dependency-expression) | Boolean | L'élément requis dépend du résultat d'une expression. |
| required(dependency-callback) | Boolean | L'élément requis dépend du résultat d'une fonction de rappel. |
| remote(url) | Boolean | Demande une validation distante. L'url est généralement une méthode d'invocation distante. |
| minlength(length) | Boolean | Définit la longueur minimale. |
| maxlength(length) | Boolean | Définit la longueur maximale. |
| rangelength(range) | Boolean | Définit une plage de longueur [min,max]. |
| min(value) | Boolean | Définit la valeur minimale. |
| max(value) | Boolean | Définir la valeur maximale. |
| email() | Boolean | Valider le format de l'e-mail. |
| range(range) | Boolean | Définir une plage de valeurs. |
| url() | Boolean | Valider le format de l'URL. |
| date() | Boolean | Valider le format de date (par exemple, 30/30/2008 ; ne valide que le format, pas l'exactitude de la date). |
| dateISO() | Boolean | Valider le format de date ISO. |
| dateDE() | Boolean | Valider le format de date allemand (29.04.1994 ou 1.1.2006). |
| number() | Boolean | Valider les nombres décimaux (y compris les décimales). |
| digits() | Boolean | Valider les nombres entiers. |
| creditcard() | Boolean | Valider les numéros de carte de crédit. |
| accept(extension) | Boolean | Valider les chaînes ayant le même suffixe. |
| equalTo(other) | Boolean | Valider si le contenu de deux champs de saisie est identique. |
| phoneUS() | Boolean | Valider les numéros de téléphone américains. |
Options de validate()
| Description | Code |
|---|---|
| debug : Active le mode débogage (le formulaire n'est pas soumis). |
$(".selector").validate
({
debug:true
})
|
| Définir debug comme valeur par défaut. |
$.validator.setDefaults({
debug:true
})
|
| submitHandler : Une fonction qui s'exécute une fois la validation réussie. Vous devez y inclure la fonction de soumission du formulaire, sinon le formulaire ne sera pas soumis. |
$(".selector").validate({
submitHandler:function(form) {
$(form).ajaxSubmit();
}
})
|
| ignore : Permet d'ignorer la validation pour certains éléments. |
$("#myform").validate({
ignore:".ignore"
})
|
| rules : Règles personnalisées sous forme clé:valeur, où la clé est l'élément à valider et la valeur peut être une chaîne ou un objet. |
$(".selector").validate({
rules:{
name:"required",
email:{
required:true,
email:true
}
}
})
|
| messages : Messages personnalisés sous forme clé:valeur, où la clé est l'élément à valider et la valeur peut être une chaîne ou une fonction. |
$(".selector").validate({
rules:{
name:"required",
email:{
required:true,
email:true
}
},
messages:{
name:"Name不能为空",
email:{
required:"E-mail不能为空",
email:"E-mail地址不正确"
}
}
})
|
| groups : Valider un groupe d'éléments avec un seul message d'erreur, et utiliser errorPlacement pour contrôler l'emplacement du message d'erreur. |
$("#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 : Type Boolean, valeur par défaut true. Spécifie s'il faut valider lors de la soumission. |
$(".selector").validate({
onsubmit:false
})
|
| onfocusout : Type Boolean, valeur par défaut true. Spécifie s'il faut valider lorsqu'un élément perd le focus. |
$(".selector").validate({
onfocusout:false
})
|
| onkeyup : Type Boolean, valeur par défaut true. Spécifie s'il faut valider lors du keyup. |
$(".selector").validate({
onkeyup:false
})
|
| onclick : Type Boolean, valeur par défaut true. Spécifie s'il faut valider lors d'un clic de souris (généralement pour les cases à cocher et les boutons radio). |
$(".selector").validate({
onclick:false
})
|
| focusInvalid : Type Boolean, valeur par défaut true. Après la soumission du formulaire, le premier élément de formulaire invalide (ou l’élément invalide qui avait le focus avant la soumission) recevra le focus. |
$(".selector").validate({
focusInvalid:false
})
|
| focusCleanup : Type Boolean, valeur par défaut false. Lorsqu’un élément invalide reçoit le focus, supprime le message d’erreur (évitez de l’utiliser avec focusInvalid). |
$(".selector").validate({
focusCleanup:true
})
|
| errorClass : Type String, valeur par défaut "error". Spécifie le nom de classe CSS pour les messages d’erreur, ce qui vous permet de personnaliser le style des messages d’erreur. |
$(".selector").validate({
errorClass:"invalid"
})
|
| errorElement : Type String, valeur par défaut "label". Spécifie quelle balise est utilisée pour marquer les erreurs. |
$(".selector").validate
errorElement:"em"
})
|
| wrapper : Type String. Spécifie quelle balise est utilisée pour envelopper l’errorElement ci-dessus. |
$(".selector").validate({
wrapper:"li"
})
|
| errorLabelContainer : Type Selector. Regroupe tous les messages d’erreur dans un conteneur. |
$("#myform").validate({
errorLabelContainer:"#messageBox",
wrapper:"li",
submitHandler:function() {
alert("Submitted!")
}
})
|
| showErrors : Prend une fonction pour afficher combien d’éléments ont échoué à la validation. |
$(".selector").validate({
showErrors:function(errorMap,errorList) {
$("#summary").html("Your form contains " + this.numberOfInvalids() + " errors,see details below.");
this.defaultShowErrors();
}
})
|
| errorPlacement : Prend une fonction pour personnaliser l’emplacement où les erreurs sont placées. |
$("#myform").validate({
errorPlacement:function(error,element) {
error.appendTo(element.parent("td").next("td"));
},
debug:true
})
|
| success : L’action après qu’un élément a réussi la validation. Si une chaîne lui est fournie, elle est traitée comme une classe CSS ; une fonction peut également être fournie. |
$("#myform").validate({
success:"valid",
submitHandler:function() {
alert("Submitted!")
}
})
|
| highlight : Permet d’ajouter des effets, un clignotement, etc., aux éléments qui échouent à la validation. |
Méthode addMethod(name, method, message)
Le paramètre name est le nom de la méthode ajoutée.
Le paramètre method est une fonction qui reçoit trois paramètres (value, element, param).
value est la valeur de l'élément, element est l'élément lui-même, et param est le paramètre.
Nous pouvons utiliser addMethod pour ajouter des méthodes de validation au-delà des méthodes de validation intégrées. Par exemple, si un champ ne peut accepter qu'une seule lettre dans la plage a-f, le code est le suivant :
$.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 champ de formulaire a name="username", alors dans rules écrivez :
username:{
af:["a","f"]
}
Le premier paramètre de addMethod est le nom de la méthode de validation ajoutée ; ici, c'est af.
Le troisième paramètre de addMethod est le message d'erreur personnalisé ; ici, le message est : "doit être une lettre et comprise entre a-f".
Le deuxième paramètre de addMethod est une fonction ; il est très important et détermine comment cette méthode de validation est utilisée.
S'il n'y a qu'un seul paramètre, écrivez-le directement, par exemple, af:"a", où a est le seul paramètre. S'il y a plusieurs paramètres, écrivez-les dans [] séparés par des virgules.
Approche par chaîne meta
$("#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>