Class: Form.Validator

Оцінює всю форму відповідно до всіх валідаторів, які налаштовані, викликаючи події, коли введення не пройшли валідацію.

Демо

Реалізує

Метод Form.Validator: Конструктор

Синтаксис

new Form.Validator(form[, options]);

Аргументи

  1. form - (mixed) Рядок з id або Element або Element посилання на форму для оцінки
  2. options - (object) набір ключ/значення опцій

Опції

  • stopOnFailure - (boolean) якщо true (за замовчуванням) форма не відправиться, якщо є помилка валідації.
  • fieldSelectors - (string) селектор для полів, які включити в валідацію; за замовчуванням "input, select, textarea"; ці селектори застосовуються лише до дочірніх елементів форми
  • useTitles - (boolean) використовувати заголовки (title) полів введення для повідомлення про помилку; перевизначає повідомлення, визначені в InputValidator (див. InputValidator); за замовчуванням false
  • evaluateOnSubmit - (boolean) чи валідувати форму при відправці користувачем; за замовчуванням true
  • evaluateFieldsOnBlur - (boolean) чи валідувати поля при події blur; за замовчуванням true
  • evaluateFieldsOnChange - (boolean) чи валідувати поля при події change; за замовчуванням true
  • serial - (boolean) чи валідувати інші поля, якщо одне поле не пройшло валідацію, крім випадків, коли змінився вміст інших полів (замість onblur); за замовчуванням true
  • ignoreHidden - (boolean) якщо true (за замовчуванням), всі поля, невидимі для користувача (display:none або батьківські елементи з display:none) не валідуються.
  • ignoreDisabled - (boolean) якщо true (за замовчуванням), всі вимкнені (disabled) поля не валідуються.
  • warningPrefix - (string) префікс для кожного попередження; за замовчуванням "Warning: "
  • errorPrefix - (string) префікс для кожної помилки; за замовчуванням "Error: "

Події

  • formValidate - (function) колбек для виконання після завершення валідації форми; ця функція отримує три аргументи: boolean (true, якщо форма пройшла валідацію); елемент form; та об'єкт події onsubmit, якщо він був (інакше undefined)
  • elementValidate - (function) колбек для виконання при перевірці поля введення. Ця функція отримує чотири аргументи: boolean (true, якщо поле пройшло валідацію), елемент input, який перевірявся, ім'я валідатора, що не пройшов, та boolean, який позначає, чи було налаштовано як попередження (true означає попередження). Примітка: цей колбек виконується для кожного валідатора.
  • elementPass - (function) колбек для виконання, коли елемент пройшов всі свої валідатори. Отримує один аргумент: елемент, який перевірявся.
  • elementFail - (function) колбек для виконання, коли елемент не пройшов один або більше своїх валідаторів. Отримує два аргументи: елемент, який перевірявся, та масив імен всіх валідаторів, що не пройшли.

Приклад

var myFormValidator = new Form.Validator($('myForm'), {
    onFormValidate: myFormHandler,
    useTitles: true
});

Примітки

© Linux.ria.com, 2008-2026