jQuery Validate
Das jQuery-Validate-Plugin bietet leistungsstarke Validierungsfunktionen für Formulare, wodurch die clientseitige Formularvalidierung einfacher wird und gleichzeitig eine große Anzahl von Anpassungsoptionen bereitgestellt wird, um verschiedene Anwendungsanforderungen zu erfüllen. Das Plugin enthält eine Reihe nützlicher Validierungsmethoden, einschließlich URL- und E-Mail-Validierung, und bietet außerdem eine API zum Schreiben benutzerdefinierter Methoden. Alle mitgelieferten Methoden verwenden standardmäßig Englisch als Fehlermeldung und wurden in 37 andere Sprachen übersetzt.
Dieses Plugin wurde von Jörn Zaefferer geschrieben und gepflegt, einem Mitglied des jQuery-Teams, einem leitenden Entwickler des jQuery-UI-Teams und dem Maintainer von QUnit. Das Plugin erschien erstmals in den frühen Tagen von jQuery im Jahr 2006 und wird seitdem aktualisiert. Die aktuelle Version ist1.14.0。
Besuchen Siedie offizielle Website von jQuery Validate, um die neueste Version des jQuery-Validate-Plugins herunterzuladen.
Importieren Sie die JS-Bibliothek (unter Verwendung des von ByteDance bereitgestellten CDN)
<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>
Standard-Validierungsregeln
| Nein. | Regel | Beschreibung |
|---|---|---|
| 1 | required:true | Das Feld ist erforderlich. |
| 2 | remote:"check.php" | Verwenden Sie die Ajax-Methode, um check.php aufzurufen und den Eingabewert zu validieren. |
| 3 | email:true | Bitte geben Sie eine E-Mail-Adresse im korrekten Format ein. |
| 4 | url:true | Bitte geben Sie eine URL im korrekten Format ein. |
| 5 | date:true | Bitte geben Sie ein Datum im korrekten Format ein. Die Datumsvalidierung schlägt in IE6 fehl; mit Vorsicht verwenden. |
| 6 | dateISO:true | Bitte geben Sie ein Datum im korrekten ISO-Format ein, zum Beispiel: 2009-06-23, 1998/01/22. Es wird nur das Format validiert, nicht die Gültigkeit. |
| 7 | number:true | Bitte geben Sie eine gültige Zahl ein (negative Zahlen, Dezimalzahlen). |
| 8 | digits:true | Bitte geben Sie eine ganze Zahl ein. |
| 9 | creditcard: | Bitte geben Sie eine gültige Kreditkartennummer ein. |
| 10 | equalTo:"#field" | Der Eingabewert muss mit #field übereinstimmen. |
| 11 | accept: | Geben Sie eine Zeichenkette mit einem gültigen Erweiterungsnamen ein (die Erweiterung der hochgeladenen Datei). |
| 12 | maxlength:5 | Geben Sie eine Zeichenkette mit einer maximalen Länge von 5 ein (chinesische Zeichen zählen als ein Zeichen). |
| 13 | minlength:10 | Geben Sie eine Zeichenkette mit einer Mindestlänge von 10 ein (chinesische Zeichen zählen als ein Zeichen). |
| 14 | rangelength:[5,10] | Geben Sie eine Zeichenkette mit einer Länge zwischen 5 und 10 ein (chinesische Zeichen zählen als ein Zeichen). |
| 15 | range:[5,10] | Der Eingabewert muss zwischen 5 und 10 liegen. |
| 16 | max:5 | Der Eingabewert darf nicht größer als 5 sein. |
| 17 | min:10 | Der Eingabewert darf nicht kleiner als 10 sein. |
Standardmeldungen
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 stellt ein chinesisches Meldungspaket bereit, das sich im Download-Paket unter dist/localization/messages_zh.js befindet, mit folgendem Inhalt:
(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} 的数值")
});
}));
Sie können diese Lokalisierungs-Meldungsdatei, dist/localization/messages_zh.js, in die Seite einbinden:
<script src="https://cdn.jsdelivr.net/npm/jquery-validation@1.20.0/dist/localization/messages_zh.min.js"></script>
Nutzung
1. Schreiben Sie die Validierungsregeln in das Steuerelement
<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. Schreiben Sie die Validierungsregeln in den JS-Code
$().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: "请选择两个主题"
}
})
});
Was den Meldungsteil betrifft: Wenn ein Steuerelement keine Meldung hat, wird die Standardmeldung verwendet.
<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: trueDer Wert ist erforderlich.
required: "#aa:checked"Wenn der Ausdruck wahr ist, ist eine Validierung erforderlich.
required: function(){}Wenn sie true zurückgibt, ist eine Validierung erforderlich.
Die letzten beiden werden häufig für Elemente in einem Formular verwendet, die zusammen ausgefüllt oder leer gelassen werden müssen.
Übliche Methoden und zu beachtende Punkte
1. Verwenden Sie andere Wege, um das standardmäßige SUBMIT zu ersetzen
$().ready(function() {
$("#signupForm").validate({
submitHandler:function(form){
alert("提交事件!");
form.submit();
}
});
});
Verwenden Sie den Ajax-Ansatz
$(".selector").validate({
submitHandler: function(form)
{
$(form).ajaxSubmit();
}
})
Sie können die Standardwerte für validate wie folgt festlegen:
$.validator.setDefaults({
submitHandler: function(form) { alert("提交事件!");form.submit(); }
});
Wenn Sie das Formular absenden möchten, müssen Sie form.submit() verwenden, nicht $(form).submit().
2. debug, nur validieren und das Formular nicht absenden
Wenn dieser Parameter true ist, wird das Formular nicht abgesendet; es wird nur validiert, was zum Debuggen sehr praktisch ist.
$().ready(function() {
$("#signupForm").validate({
debug:true
});
});
Wenn es mehrere Formulare auf einer Seite gibt, die alle auf debug gesetzt werden sollen, verwenden Sie:
$.validator.setDefaults({
debug: true
})
3. ignore: bestimmte Elemente ohne Validierung ignorieren
ignore: ".ignore"
4. Ändern Sie die Position, an der Fehlermeldungen angezeigt werden
errorPlacement:Callback
Geben Sie die Position an, an der Fehler platziert werden. Standardmäßig gilt: error.appendTo(element.parent()); das heißt, die Fehlermeldung wird nach dem zu validierenden Element platziert.
errorPlacement: function(error, element) {
error.appendTo(element.parent());
}
Beispiel
<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>
Der Zweck des Codes ist: Normalerweise wird die Fehlermeldung in
| Parameter | Type | Beschreibung | Standardwert |
|---|---|---|---|
| errorClass | String | Geben Sie den CSS-Klassennamen für Fehlermeldungen an; Sie können den Stil der Fehlermeldungen anpassen. | "error" |
| errorElement | String | Das zum Markieren von Fehlern verwendete Tag; standardmäßig ist es label und kann in em geändert werden. | "label" |
| errorContainer | Selektor | Validierungsinformationen ein- oder ausblenden. Es kann das Container-Attribut automatisch ändern, sodass es angezeigt wird, wenn eine Fehlermeldung erscheint, und ausgeblendet wird, wenn kein Fehler vorliegt; es ist wenig nützlich. errorContainer: "#messageBox1, #messageBox2" |
|
| errorLabelContainer | Selektor | Alle Fehlermeldungen in einem Container zusammenfassen. | |
| wrapper | String | Mit welchem Tag das obige errorElement umschlossen werden soll. |
Im Allgemeinen werden diese drei Attribute zusammen verwendet, um alle Fehlermeldungen in einem Container anzuzeigen und sie automatisch auszublenden, wenn keine Meldung vorhanden ist.
errorContainer: "div.error",
errorLabelContainer: $("#signupForm div.error"),
wrapper: "li"
5. Den Stil der Anzeige von Fehlermeldungen ändern
Den Stil der Fehlermeldungen festlegen; der Anzeige können Symbole hinzugefügt werden. In diesem System wurde eigens eine validation.css erstellt, um die Stile der Validierungsdateien zu pflegen.
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. Eine Funktion ausführen, nachdem jedes Feld die Validierung bestanden hat
success:String,Callback
Die Aktion, nachdem ein zu validierendes Element die Validierung bestanden hat. Wenn eine Zeichenkette angegeben wird, wird sie als CSS-Klasse behandelt; es kann auch eine Funktion angegeben werden.
success: function(label) {
// set as text for IE
label.html(" ").addClass("checked");
//label.addClass("valid").text("Ok!")
}
Dem validierten Element "valid" hinzufügen und den Stil in CSS als <style>label.valid {}</style> definieren.
success: "valid"
7. Die Auslösemethode der Validierung ändern
Die folgenden sind vom Typ Boolean, aber es wird empfohlen, sie nicht leichtfertig hinzuzufügen, es sei denn, Sie müssen sie auf false setzen.
| Auslösemethode | Type | Beschreibung | Standardwert |
|---|---|---|---|
| onsubmit | Boolean | Validierung beim Absenden. Auf false setzen, um andere Methoden zur Validierung zu verwenden. | wahr |
| onfocusout | Boolean | Validierung bei Blur (außer bei Checkboxen/Radiobuttons). | wahr |
| onkeyup | Boolean | Validierung bei keyup. | wahr |
| onclick | Boolean | Validierung beim Anklicken von Checkboxen und Radiobuttons. | wahr |
| focusInvalid | Boolean | Nach dem Absenden des Formulars erhält das Formular, das die Validierung nicht besteht (das erste oder das ungültige Formular, das vor dem Absenden den Fokus erhalten hat), den Fokus. | wahr |
| focusCleanup | Boolean | Wenn true, wird die Fehlermeldung entfernt, wenn ein Element, das die Validierung nicht besteht, den Fokus erhält. Vermeiden Sie die Verwendung zusammen mit focusInvalid. | false |
// 重置表单
$().ready(function() {
var validator = $("#signupForm").validate({
submitHandler:function(form){
alert("submitted");
form.submit();
}
});
$("#reset").click(function() {
validator.resetForm();
});
});
8. Asynchrone Validierung
remote:URL
Verwenden Sie ajax zur Validierung. Standardmäßig wird der aktuell validierte Wert an die Remote-Adresse übermittelt. Wenn Sie andere Werte übermitteln müssen, können Sie die Option data verwenden.
remote: "check-email.php"
remote: {
url: "check-email.php", //后台处理程序
type: "post", //数据发送方式
dataType: "json", //接受数据格式
data: { //要传递的数据
username: function() {
return $("#username").val();
}
}
}
Die Remote-Adresse darf nur "true" oder "false" ausgeben und darf keine andere Ausgabe haben.
9. Benutzerdefinierte Validierung hinzufügen
addMethod:name, method, message
Benutzerdefinierte Validierungsmethode
// 中文字两个字节
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));
}, "请正确填写您的邮政编码");
Hinweis: Sie sollte in der Datei additional-methods.js oder in der Datei jquery.validate.js hinzugefügt werden. Es wird empfohlen, sie im Allgemeinen in die Datei additional-methods.js zu schreiben.
Hinweis: Fügen Sie sie in die Datei messages_cn.js ein: isZipCode: "darf nur chinesische Zeichen, englische Buchstaben, Zahlen und Unterstriche enthalten". Fügen Sie vor dem Aufruf einen Verweis auf die Datei additional-methods.js hinzu.
10. Validierung von radio, checkbox und select
Bei radio bedeutet required, dass eines ausgewählt werden muss.
<input type="radio" id="gender_male" value="m" name="gender" required /> <input type="radio" id="gender_female" value="f" name="gender"/>
Bei checkbox bedeutet required, dass sie angehakt sein muss.
<input type="checkbox" class="checkbox" id="agree" name="agree" required />
Bei checkbox gibt minlength die Mindestanzahl der erforderlichen Auswahlen an, maxlength die maximale Anzahl der Auswahlen, und rangelength:[2,3] gibt einen Bereich für die Anzahl der Auswahlen an.
<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[]" />
Bei select bedeutet required, dass der ausgewählte Wert nicht leer sein darf.
<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>
Bei select gibt minlength die Mindestanzahl der ausgewählten Einträge an (für Mehrfachauswahl-Selects), maxlength die maximale Anzahl der ausgewählten Einträge, und rangelength:[2,3] gibt einen Bereich für die Anzahl der ausgewählten Einträge an.
<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>
jQuery.validate Chinesische API
| Name | Rückgabetyp | Beschreibung |
|---|---|---|
| validate(options) | Validator | Das ausgewählte Formular validieren. |
| valid() | Boolean | Prüfen, ob die Validierung erfolgreich war. |
| rules() | Optionen | Die Validierungsregeln für ein Element zurückgeben. |
| rules("add",rules) | Optionen | Validierungsregeln hinzufügen. |
| rules("remove",rules) | Optionen | Validierungsregeln entfernen. |
| removeAttrs(attributes) | Optionen | Spezielle Attribute entfernen und sie zurückgeben. |
| Benutzerdefinierte Selektoren | ||
| :blank | Validator | Filter für Elemente ohne Wert. |
| :filled | Array <Element> | Filter für Elemente mit einem Wert. |
| :unchecked | Array <Element> | Filter für Elemente, die nicht ausgewählt sind. |
| Hilfsprogramme | ||
| jQuery.format(template,argument,argumentN...) | String | Ersetzt {n} in der Vorlage durch Argumente. |
Validator
Die validate-Methode gibt ein Validator-Objekt zurück. Das Validator-Objekt besitzt viele Methoden, mit denen die Validierung ausgelöst oder der Formularinhalt geändert werden kann. Nachfolgend sind einige häufig verwendete Methoden aufgeführt.
| Name | Rückgabetyp | Beschreibung |
|---|---|---|
| form() | Boolean | Validiert das Formular und gibt Erfolg oder Misserfolg zurück. |
| element(element) | Boolean | Validiert ein einzelnes Element auf Erfolg oder Misserfolg. |
| resetForm() | undefined | Stellt das zuvor validierte Formular in seinen ursprünglichen Zustand vor der Validierung wieder her. |
| showErrors(errors) | undefined | Zeigt eine bestimmte Fehlermeldung an. |
| Validator-Funktionen | ||
| setDefaults(defaults) | undefined | Standard ändern. |
| addMethod(name,method,message) | undefined | Fügt eine neue Validierungsmethode hinzu. Sie muss einen eindeutigen Namen, eine JavaScript-Methode und eine Standardmeldung enthalten. |
| addClassRules(name,rules) | undefined | Fügt einen zusammengesetzten Validierungstyp hinzu, nützlich, wenn mehrere Validierungsmethoden in einer Klasse verwendet werden. |
| addClassRules(rules) | undefined | Fügt zusammengesetzte Validierungstypen hinzu, nützlich, wenn mehrere Validierungsmethoden in einer Klasse verwendet werden. Diese Variante fügt mehrere Validierungsmethoden gleichzeitig hinzu. |
Integrierte Validierungsmethoden
| Name | Rückgabetyp | Beschreibung |
|---|---|---|
| required() | Boolean | Erforderliche Validierung für ein Element. |
| required(dependency-expression) | Boolean | Erforderliches Element hängt vom Ergebnis eines Ausdrucks ab. |
| required(dependency-callback) | Boolean | Erforderliches Element hängt vom Ergebnis einer Callback-Funktion ab. |
| remote(url) | Boolean | Remote-Validierung anfordern. Die url ist üblicherweise eine remote aufgerufene Methode. |
| minlength(length) | Boolean | Legt die Mindestlänge fest. |
| maxlength(length) | Boolean | Legt die maximale Länge fest. |
| rangelength(range) | Boolean | Legt einen Längenbereich [min,max] fest. |
| min(value) | Boolean | Legt den Mindestwert fest. |
| max(value) | Boolean | Den maximalen Wert festlegen. |
| email() | Boolean | E-Mail-Format validieren. |
| range(range) | Boolean | Einen Wertebereich festlegen. |
| url() | Boolean | URL-Format validieren. |
| date() | Boolean | Datumsformat validieren (z. B. 30/30/2008; validiert nur das Format, nicht die Richtigkeit des Datums). |
| dateISO() | Boolean | ISO-Datumsformat validieren. |
| dateDE() | Boolean | Deutsches Datumsformat validieren (29.04.1994 oder 1.1.2006). |
| number() | Boolean | Dezimalzahlen validieren (einschließlich Dezimalstellen). |
| digits() | Boolean | Ganzzahlen validieren. |
| creditcard() | Boolean | Kreditkartennummern validieren. |
| accept(extension) | Boolean | Zeichenketten mit demselben Suffix validieren. |
| equalTo(other) | Boolean | Validieren, ob der Inhalt zweier Eingabefelder identisch ist. |
| phoneUS() | Boolean | US-Telefonnummern validieren. |
validate()-Optionen
| Beschreibung | Code |
|---|---|
| debug: Aktiviert den Debug-Modus (das Formular wird nicht übermittelt). |
$(".selector").validate
({
debug:true
})
|
| debug als Standard festlegen. |
$.validator.setDefaults({
debug:true
})
|
| submitHandler: Eine Funktion, die ausgeführt wird, nachdem die Validierung erfolgreich war. Die Funktion zum Absenden des Formulars muss darin eingebunden werden, andernfalls wird das Formular nicht übermittelt. |
$(".selector").validate({
submitHandler:function(form) {
$(form).ajaxSubmit();
}
})
|
| ignore: Überspringt die Validierung für bestimmte Elemente. |
$("#myform").validate({
ignore:".ignore"
})
|
| rules: Benutzerdefinierte Regeln in der Form key:value, wobei key das zu validierende Element ist und value ein String oder ein Objekt sein kann. |
$(".selector").validate({
rules:{
name:"required",
email:{
required:true,
email:true
}
}
})
|
| messages: Benutzerdefinierte Meldungen in der Form key:value, wobei key das zu validierende Element ist und value ein String oder eine Funktion sein kann. |
$(".selector").validate({
rules:{
name:"required",
email:{
required:true,
email:true
}
},
messages:{
name:"Name不能为空",
email:{
required:"E-mail不能为空",
email:"E-mail地址不正确"
}
}
})
|
| groups: Validiert eine Gruppe von Elementen mit einer Fehlermeldung und verwendet errorPlacement, um zu steuern, wo die Fehlermeldung platziert wird. |
$("#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: Typ Boolean, Standard true. Gibt an, ob beim Absenden validiert werden soll. |
$(".selector").validate({
onsubmit:false
})
|
| onfocusout: Typ Boolean, Standard true. Gibt an, ob validiert werden soll, wenn ein Element den Fokus verliert. |
$(".selector").validate({
onfocusout:false
})
|
| onkeyup: Typ Boolean, Standard true. Gibt an, ob bei keyup validiert werden soll. |
$(".selector").validate({
onkeyup:false
})
|
| onclick: Typ Boolean, Standard true. Gibt an, ob bei einem Mausklick validiert werden soll (normalerweise für Checkbox und Radiobox). |
$(".selector").validate({
onclick:false
})
|
| focusInvalid: Typ Boolean, Standardwert true. Nach dem Absenden des Formulars erhält das erste ungültige Formularelement (oder das ungültige Element, das vor dem Absenden den Fokus hatte) den Fokus. |
$(".selector").validate({
focusInvalid:false
})
|
| focusCleanup: Typ Boolean, Standardwert false. Wenn ein ungültiges Element den Fokus erhält, wird die Fehlermeldung entfernt (nicht zusammen mit focusInvalid verwenden). |
$(".selector").validate({
focusCleanup:true
})
|
| errorClass: Typ String, Standardwert "error". Gibt den CSS-Klassennamen für Fehlermeldungen an, sodass Sie den Stil der Fehlermeldungen anpassen können. |
$(".selector").validate({
errorClass:"invalid"
})
|
| errorElement: Typ String, Standardwert "label". Gibt an, welches Tag zur Markierung von Fehlern verwendet wird. |
$(".selector").validate
errorElement:"em"
})
|
| wrapper: Typ String. Gibt an, welches Tag zum Umschließen des obigen errorElement verwendet wird. |
$(".selector").validate({
wrapper:"li"
})
|
| errorLabelContainer: Typ Selector. Alle Fehlermeldungen in einem Container zusammenfassen. |
$("#myform").validate({
errorLabelContainer:"#messageBox",
wrapper:"li",
submitHandler:function() {
alert("Submitted!")
}
})
|
| showErrors: Nimmt eine Funktion entgegen, um anzuzeigen, wie viele Elemente die Validierung nicht bestanden haben. |
$(".selector").validate({
showErrors:function(errorMap,errorList) {
$("#summary").html("Your form contains " + this.numberOfInvalids() + " errors,see details below.");
this.defaultShowErrors();
}
})
|
| errorPlacement: Nimmt eine Funktion entgegen, um anzupassen, wo Fehler platziert werden. |
$("#myform").validate({
errorPlacement:function(error,element) {
error.appendTo(element.parent("td").next("td"));
},
debug:true
})
|
| success: Die Aktion, nachdem ein Element die Validierung bestanden hat. Wenn ein String angegeben wird, wird er als CSS-Klasse behandelt; es kann auch eine Funktion angegeben werden. |
$("#myform").validate({
success:"valid",
submitHandler:function() {
alert("Submitted!")
}
})
|
| highlight: Kann Effekte, Blinken usw. zu Elementen hinzufügen, die die Validierung nicht bestanden haben. |
addMethod(name, method, message)-Methode
Der Parameter name ist der Name der Methode, die hinzugefügt wird.
Die Parameter-Methode ist eine Funktion, die drei Parameter empfängt (value, element, param).
value ist der Wert des Elements, element ist das Element selbst und param ist der Parameter.
Wir können addMethod verwenden, um Validierungsmethoden über die integrierten Validierungsmethoden hinaus hinzuzufügen. Wenn ein Feld beispielsweise nur einen Buchstaben im Bereich a-f akzeptieren kann, sieht der Code wie folgt aus:
$.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");
Wenn ein Formularfeld name="username" hat, dann schreibe in rules:
username:{
af:["a","f"]
}
Der erste Parameter von addMethod ist der Name der hinzugefügten Validierungsmethode; hier ist es af.
Der dritte Parameter von addMethod ist die benutzerdefinierte Fehlermeldung; hier lautet die Meldung: "muss ein Buchstabe und im Bereich a-f sein".
Der zweite Parameter von addMethod ist eine Funktion; sie ist ziemlich wichtig und bestimmt, wie diese Validierungsmethode verwendet wird.
Wenn es nur einen Parameter gibt, schreibe ihn direkt, z. B. af:"a", wobei a der einzige Parameter ist. Wenn es mehrere Parameter gibt, schreibe sie in [] durch Kommas getrennt.
Meta-String-Ansatz
$("#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>