jQuery Validate
Плагин jQuery Validate предоставляет мощные функции проверки для форм, делая проверку форм на стороне клиента проще и предоставляя большое количество параметров настройки для удовлетворения различных потребностей приложений. Плагин включает набор полезных методов проверки, включая проверку URL и email, а также предоставляет API для написания пользовательских методов. Все встроенные методы по умолчанию используют английский язык для сообщений об ошибках и были переведены на 37 других языков.
Этот плагин был написан и поддерживается Jörn Zaefferer, участником команды jQuery, ведущим разработчиком команды jQuery UI и сопровождающим QUnit. Плагин впервые появился в первые дни jQuery в 2006 году и с тех пор постоянно обновляется. Текущая версия —1.14.0。
Посетитеофициальный сайт jQuery Validateчтобы скачать последнюю версию плагина jQuery Validate.
Подключите js-библиотеку (используя CDN, предоставленный 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>
Правила валидации по умолчанию
| Нет. | Правило | Описание |
|---|---|---|
| 1 | required:true | Поле обязательно для заполнения. |
| 2 | remote:"check.php" | Используйте метод ajax для вызова check.php, чтобы проверить введённое значение. |
| 3 | email:true | Необходимо ввести адрес электронной почты в правильном формате. |
| 4 | url:true | Необходимо ввести URL в правильном формате. |
| 5 | date:true | Необходимо ввести дату в правильном формате. Проверка даты не работает в IE6; используйте с осторожностью. |
| 6 | dateISO:true | Необходимо ввести дату в правильном формате ISO, например: 2009-06-23, 1998/01/22. Проверяется только формат, а не корректность. |
| 7 | number:true | Необходимо ввести корректное число (отрицательные числа, десятичные дроби). |
| 8 | digits:true | Необходимо ввести целое число. |
| 9 | creditcard: | Необходимо ввести действительный номер кредитной карты. |
| 10 | equalTo:"#field" | Введённое значение должно совпадать с #field. |
| 11 | accept: | Необходимо ввести строку с допустимым именем расширения (расширением загруженного файла). |
| 12 | maxlength:5 | Введите строку максимальной длиной 5 (китайские иероглифы считаются одним символом). |
| 13 | minlength:10 | Введите строку минимальной длиной 10 (китайские иероглифы считаются одним символом). |
| 14 | rangelength:[5,10] | Введите строку длиной от 5 до 10 (китайские иероглифы считаются одним символом). |
| 15 | range:[5,10] | Вводимое значение должно быть между 5 и 10. |
| 16 | max:5 | Вводимое значение не может быть больше 5. |
| 17 | min:10 | Вводимое значение не может быть меньше 10. |
Сообщения по умолчанию
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 предоставляет пакет сообщений на китайском языке, расположенный в dist/localization/messages_zh.js в скачанном пакете, со следующим содержимым:
(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} 的数值")
});
}));
Вы можете подключить этот файл сообщений локализации, dist/localization/messages_zh.js, к странице:
<script src="https://cdn.jsdelivr.net/npm/jquery-validation@1.20.0/dist/localization/messages_zh.min.js"></script>
Использование
1. Запишите правила проверки в элемент управления
<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. Запишите правила проверки в 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: "请选择两个主题"
}
})
});
Что касается части с сообщениями, если у элемента управления нет сообщения, будет использовано сообщение по умолчанию.
<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: trueЗначение обязательно.
required: "#aa:checked"Если выражение истинно, валидация обязательна.
required: function(){}Если она возвращает true, валидация обязательна.
Последние два обычно используются для элементов формы, которые должны быть заполнены или оставлены пустыми вместе.
Распространённые методы и важные замечания
1. Используйте другие способы вместо стандартного SUBMIT
$().ready(function() {
$("#signupForm").validate({
submitHandler:function(form){
alert("提交事件!");
form.submit();
}
});
});
Используйте подход с ajax
$(".selector").validate({
submitHandler: function(form)
{
$(form).ajaxSubmit();
}
})
Вы можете задать значения по умолчанию для validate следующим образом:
$.validator.setDefaults({
submitHandler: function(form) { alert("提交事件!");form.submit(); }
});
Если вы хотите отправить форму, нужно использовать form.submit(), а не $(form).submit().
2. debug — только валидация, без отправки формы
Если этот параметр равен true, форма не будет отправлена; выполняется только валидация, что очень удобно для отладки.
$().ready(function() {
$("#signupForm").validate({
debug:true
});
});
Если на странице несколько форм и для всех нужно установить debug, используйте:
$.validator.setDefaults({
debug: true
})
3. ignore: игнорировать определённые элементы без валидации
ignore: ".ignore"
4. Изменить позицию отображения сообщений об ошибках
errorPlacement:Callback
Укажите позицию, куда помещаются ошибки. По умолчанию: error.appendTo(element.parent()); то есть сообщение об ошибке размещается после проверяемого элемента.
errorPlacement: function(error, element) {
error.appendTo(element.parent());
}
Пример
<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>
Назначение кода: обычно сообщение об ошибке отображается в
| Параметр | Type | Описание | Значение по умолчанию |
|---|---|---|---|
| errorClass | String | Укажите имя CSS-класса для сообщений об ошибках; можно настроить стиль сообщений об ошибках. | "error" |
| errorElement | String | Тег, используемый для отметки ошибок; по умолчанию label, его можно изменить на em. | "label" |
| errorContainer | Селектор | Показывать или скрывать информацию о валидации. Позволяет автоматически изменять атрибут container, чтобы отображать его при появлении сообщения об ошибке и скрывать при отсутствии ошибки; малополезно. errorContainer: "#messageBox1, #messageBox2" |
|
| errorLabelContainer | Селектор | Поместите все сообщения об ошибках в один контейнер. | |
| wrapper | String | Какой тег использовать для обёртывания вышеуказанного errorElement. |
Обычно эти три атрибута используются вместе, чтобы отображать все сообщения об ошибках в одном контейнере и автоматически скрывать их, когда сообщений нет.
errorContainer: "div.error",
errorLabelContainer: $("#signupForm div.error"),
wrapper: "li"
5. Изменение стиля отображения сообщений об ошибках
Задайте стиль сообщений об ошибках; в отображение можно добавить значки. В этой системе специально создан validation.css для поддержки стилей файлов проверки.
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. Выполнение функции после успешной проверки каждого поля
success:String,Callback
Действие после того, как проверяемый элемент проходит проверку. Если указана строка, она будет рассматриваться как CSS-класс; также можно указать функцию.
success: function(label) {
// set as text for IE
label.html(" ").addClass("checked");
//label.addClass("valid").text("Ok!")
}
Добавьте "valid" к проверяемому элементу и определите стиль в CSS как <style>label.valid {}</style>.
success: "valid"
7. Изменение способа запуска проверки
Следующие параметры имеют логический тип, но рекомендуется не добавлять их без необходимости, если только вам не нужно изменить их на false.
| Способ запуска | Type | Описание | Значение по умолчанию |
|---|---|---|---|
| onsubmit | Boolean | Проверять при отправке. Установите false, чтобы использовать другие методы проверки. | истина |
| onfocusout | Boolean | Проверять при потере фокуса (кроме флажков/радиокнопок). | истина |
| onkeyup | Boolean | Проверять при отпускании клавиши. | истина |
| onclick | Boolean | Проверять при щелчке по флажкам и радиокнопкам. | истина |
| focusInvalid | Boolean | После отправки формы фокус получит элемент, не прошедший проверку (первый или недопустимый элемент, получивший фокус до отправки). | истина |
| focusCleanup | Boolean | Если true, когда элемент, не прошедший проверку, получает фокус, сообщение об ошибке удаляется. Избегайте использования вместе с focusInvalid. | false |
// 重置表单
$().ready(function() {
var validator = $("#signupForm").validate({
submitHandler:function(form){
alert("submitted");
form.submit();
}
});
$("#reset").click(function() {
validator.resetForm();
});
});
8. Асинхронная проверка
remote:URL
Используйте ajax для валидации. По умолчанию текущее проверяемое значение отправляется на удалённый адрес. Если нужно отправить другие значения, можно использовать параметр data.
remote: "check-email.php"
remote: {
url: "check-email.php", //后台处理程序
type: "post", //数据发送方式
dataType: "json", //接受数据格式
data: { //要传递的数据
username: function() {
return $("#username").val();
}
}
}
Удалённый адрес может выводить только "true" или "false" и не может иметь никакого другого вывода.
9. Добавление пользовательской валидации
addMethod:name, method, message
Пользовательский метод валидации
// 中文字两个字节
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));
}, "请正确填写您的邮政编码");
Примечание: Его следует добавить в файл additional-methods.js или в файл jquery.validate.js. Рекомендуется обычно записывать его в файл additional-methods.js.
Примечание: Добавьте это в файл messages_cn.js: isZipCode: "может содержать только китайские иероглифы, английские буквы, цифры и символы подчёркивания". Перед вызовом добавьте ссылку на файл additional-methods.js.
10. Валидация radio, checkbox и select
Для radio required означает, что должен быть выбран один вариант.
<input type="radio" id="gender_male" value="m" name="gender" required /> <input type="radio" id="gender_female" value="f" name="gender"/>
Для checkbox required означает, что он должен быть отмечен.
<input type="checkbox" class="checkbox" id="agree" name="agree" required />
Для checkbox minlength указывает минимальное требуемое количество выбранных элементов, maxlength указывает максимальное количество выбранных элементов, а rangelength:[2,3] указывает диапазон количества выбранных элементов.
<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[]" />
Для select required означает, что выбранное значение не может быть пустым.
<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>
Для select minlength указывает минимальное количество выбранных элементов (для select с множественным выбором), maxlength указывает максимальное количество выбранных элементов, а rangelength:[2,3] указывает диапазон количества выбранных элементов.
<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 Китайский API
| Name | Тип возвращаемого значения | Описание |
|---|---|---|
| validate(options) | Валидатор | Проверяет выбранную форму. |
| valid() | Boolean | Проверяет, прошла ли валидация. |
| rules() | Параметры | Возвращает правила валидации для элемента. |
| rules("add",rules) | Параметры | Добавляет правила валидации. |
| rules("remove",rules) | Параметры | Удаляет правила валидации. |
| removeAttrs(attributes) | Параметры | Удалить специальные атрибуты и вернуть их. |
| Пользовательские селекторы | ||
| :blank | Валидатор | Фильтр для элементов без значения. |
| :filled | Array <Element> | Фильтр для элементов со значением. |
| :unchecked | Array <Element> | Фильтр для элементов, которые не выбраны. |
| Служебные инструменты | ||
| jQuery.format(template,argument,argumentN...) | String | Заменить {n} в шаблоне на аргументы. |
Валидатор
Метод validate возвращает объект Validator. Объект Validator имеет множество методов, которые можно использовать для запуска валидации или изменения содержимого формы. Ниже приведены некоторые часто используемые методы.
| Name | Тип возвращаемого значения | Описание |
|---|---|---|
| form() | Boolean | Проверяет форму и возвращает успех или неудачу. |
| element(element) | Boolean | Проверяет отдельный элемент на успех или неудачу. |
| resetForm() | undefined | Восстанавливает ранее проверенную форму в исходное состояние до валидации. |
| showErrors(errors) | undefined | Отображает конкретное сообщение об ошибке. |
| Функции Validator | ||
| setDefaults(defaults) | undefined | Изменяет настройки по умолчанию. |
| addMethod(name,method,message) | undefined | Добавьте новый метод валидации. Он должен включать уникальное имя, JavaScript-метод и сообщение по умолчанию. |
| addClassRules(name,rules) | undefined | Добавьте составной тип валидации, полезный при использовании нескольких методов валидации в одном классе. |
| addClassRules(rules) | undefined | Добавьте составные типы валидации, полезные при использовании нескольких методов валидации в одном классе. Этот позволяет добавить несколько методов валидации одновременно. |
Встроенные методы валидации
| Name | Тип возвращаемого значения | Описание |
|---|---|---|
| required() | Boolean | Обязательная валидация для элемента. |
| required(dependency-expression) | Boolean | Обязательность элемента зависит от результата выражения. |
| required(dependency-callback) | Boolean | Обязательный элемент зависит от результата функции обратного вызова. |
| remote(url) | Boolean | Запросить удалённую проверку. url обычно является методом удалённого вызова. |
| minlength(length) | Boolean | Установить минимальную длину. |
| maxlength(length) | Boolean | Установить максимальную длину. |
| rangelength(range) | Boolean | Установить диапазон длины [min,max]. |
| min(value) | Boolean | Установить минимальное значение. |
| max(value) | Boolean | Устанавливает максимальное значение. |
| email() | Boolean | Проверяет формат электронной почты. |
| range(range) | Boolean | Задаёт диапазон значений. |
| url() | Boolean | Проверяет формат URL. |
| date() | Boolean | Проверяет формат даты (например, 30/30/2008; проверяется только формат, а не корректность даты). |
| dateISO() | Boolean | Проверяет формат даты ISO. |
| dateDE() | Boolean | Проверяет немецкий формат даты (29.04.1994 или 1.1.2006). |
| number() | Boolean | Проверяет десятичные числа (включая десятичные дроби). |
| digits() | Boolean | Проверяет целые числа. |
| creditcard() | Boolean | Проверяет номера кредитных карт. |
| accept(extension) | Boolean | Проверяет строки с одинаковым суффиксом. |
| equalTo(other) | Boolean | Проверяет, одинаково ли содержимое двух полей ввода. |
| phoneUS() | Boolean | Проверяет телефонные номера США. |
Параметры validate()
| Описание | Code |
|---|---|
| debug: включить режим отладки (форма не отправляется). |
$(".selector").validate
({
debug:true
})
|
| Установить debug как значение по умолчанию. |
$.validator.setDefaults({
debug:true
})
|
| submitHandler: функция, которая выполняется после успешного прохождения валидации. Внутри неё нужно включить функцию отправки формы, иначе форма не будет отправлена. |
$(".selector").validate({
submitHandler:function(form) {
$(form).ajaxSubmit();
}
})
|
| ignore: пропускать валидацию для определённых элементов. |
$("#myform").validate({
ignore:".ignore"
})
|
| rules: пользовательские правила в формате key:value, где key — элемент для валидации, а value может быть строкой или объектом. |
$(".selector").validate({
rules:{
name:"required",
email:{
required:true,
email:true
}
}
})
|
| messages: пользовательские сообщения в формате key:value, где key — элемент для валидации, а value может быть строкой или функцией. |
$(".selector").validate({
rules:{
name:"required",
email:{
required:true,
email:true
}
},
messages:{
name:"Name不能为空",
email:{
required:"E-mail不能为空",
email:"E-mail地址不正确"
}
}
})
|
| groups: валидировать группу элементов с одним сообщением об ошибке и использовать errorPlacement для управления местом размещения сообщения об ошибке. |
$("#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: тип Boolean, по умолчанию true. Указывает, выполнять ли валидацию при отправке. |
$(".selector").validate({
onsubmit:false
})
|
| onfocusout: тип Boolean, по умолчанию true. Указывает, выполнять ли валидацию, когда элемент теряет фокус. |
$(".selector").validate({
onfocusout:false
})
|
| onkeyup: тип Boolean, по умолчанию true. Указывает, выполнять ли валидацию при событии keyup. |
$(".selector").validate({
onkeyup:false
})
|
| onclick: тип Boolean, по умолчанию true. Указывает, выполнять ли валидацию при щелчке мышью (обычно для checkbox и radiobox). |
$(".selector").validate({
onclick:false
})
|
| focusInvalid: Тип Boolean, по умолчанию true. После отправки формы фокус получит первый недействительный элемент формы (или недействительный элемент, находившийся в фокусе перед отправкой). |
$(".selector").validate({
focusInvalid:false
})
|
| focusCleanup: Тип Boolean, по умолчанию false. Когда недействительный элемент получает фокус, сообщение об ошибке удаляется (не используйте вместе с focusInvalid). |
$(".selector").validate({
focusCleanup:true
})
|
| errorClass: Тип String, по умолчанию "error". Задаёт имя CSS-класса для сообщений об ошибках, позволяя настраивать стиль сообщений об ошибках. |
$(".selector").validate({
errorClass:"invalid"
})
|
| errorElement: Тип String, по умолчанию "label". Указывает, какой тег используется для пометки ошибок. |
$(".selector").validate
errorElement:"em"
})
|
| wrapper: Тип String. Указывает, какой тег используется для обёртки вышеуказанного errorElement. |
$(".selector").validate({
wrapper:"li"
})
|
| errorLabelContainer: Тип Selector. Поместите все сообщения об ошибках вместе в контейнер. |
$("#myform").validate({
errorLabelContainer:"#messageBox",
wrapper:"li",
submitHandler:function() {
alert("Submitted!")
}
})
|
| showErrors: Принимает функцию для отображения того, сколько элементов не прошли валидацию. |
$(".selector").validate({
showErrors:function(errorMap,errorList) {
$("#summary").html("Your form contains " + this.numberOfInvalids() + " errors,see details below.");
this.defaultShowErrors();
}
})
|
| errorPlacement: Принимает функцию для настройки размещения ошибок. |
$("#myform").validate({
errorPlacement:function(error,element) {
error.appendTo(element.parent("td").next("td"));
},
debug:true
})
|
| success: Действие после успешного прохождения валидации элементом. Если передана строка, она рассматривается как CSS-класс; также можно передать функцию. |
$("#myform").validate({
success:"valid",
submitHandler:function() {
alert("Submitted!")
}
})
|
| highlight: Может добавлять эффекты, мигание и т. п. к элементам, не прошедшим валидацию. |
метод addMethod(name, method, message)
Параметр name — это имя добавляемого метода.
Метод с параметрами — это функция, которая принимает три параметра (value, element, param).
value — это значение элемента, element — сам элемент, а param — параметр.
С помощью addMethod можно добавлять методы валидации помимо встроенных. Например, если поле может принимать только одну букву в диапазоне a-f, код выглядит так:
$.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");
Если поле формы имеет name="username", то в rules пишем:
username:{
af:["a","f"]
}
Первый параметр addMethod — это имя добавляемого метода валидации; здесь это af.
Третий параметр addMethod — это настраиваемое сообщение об ошибке; здесь сообщение: "должно быть буквой в диапазоне a-f".
Второй параметр addMethod — это функция; он очень важен и определяет, как используется этот метод валидации.
Если параметр только один, пишите его напрямую, например af:"a", где a — единственный параметр. Если параметров несколько, записывайте их в [] через запятую.
Подход 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>