Class: Form.Validator.Inline

Оцінює всю форму відповідно до всіх валідаторів, які налаштовані для відображення повідомлень в рядку на сторінці.

Розширює

• Form.Validator

Реалізує

• Options, Events

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

Синтаксис

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

Аргументи

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

Опції

• всі опції, визначені для Form.Validator, плюс
• scrollToErrorsOnSubmit - (boolean) якщо true (за замовчуванням), коли користувач відправляє форму, вікно (або батьківський елемент з переповненням) прокрутиться до цього елемента, щоб він був у зоні видимості. Використовує Fx.Scroll, якщо він доступний, інакше просто переходить до елемента.
• scrollToErrorsOnBlur - (boolean) За замовчуванням false, але якщо true, події blur будуть прив'язані до полів вводу, що спричинить прокрутку до відповідного поля з помилкою.
• scrollToErrorsOnChange - (boolean) За замовчуванням false, але якщо true, події change будуть прив'язані до полів вводу, що спричинить прокрутку до відповідного поля з помилкою.
• scrollFxOptions - (object) опції для Fx.Scroll, якщо він доступний; використовується для прокрутки до помилок, якщо scrollToErrorsOnSubmit є true.
• showError - (function) функція, яка використовується для відображення повідомлень. Отримує елемент повідомлення, який вже вставлено в документ і потребує встановлення display у block. За замовчуванням цей метод використовує [Fx.Reveal][] для плавного відображення повідомлення (якщо завантажено), інакше просто встановлює стиль display у block.
• hideError - (function) функція, яка використовується для приховування повідомлень. Працює точно так само, як опція showAdvice вище, але призначена для приховування повідомлення. Використовує [Fx.Reveal][], якщо можливо, інакше встановлює display у none.

Події

• всі події, визначені для Form.Validator, плюс
• onShowAdvice - (function) зворотний виклик, що виконується при показі поради. Отримує три аргументи: посилання Element на перевірюване поле вводу, посилання Element на елемент поради та ім'я невдалої перевірки.
• onHideAdvice - (function) зворотний виклик, що виконується при показі поради. Отримує три аргументи: посилання Element на перевірюване поле вводу, посилання Element на елемент поради та ім'я невдалої перевірки.

Примітка

• Ви можете визначити значення data-validators під назвою msgPos як id елемента, у який будуть вставлені помилки перевірки для цього поля вводу. Приклад:

  <input data-validators="validate-email msgPos:'emailAdvice'">
  <div id="emailAdvice"></div>
  

Метод Form.Validator.Inline: getAllAdviceMessages

Повертає всі повідомлення, які може створити поле вводу, незалежно від вводу користувача.

Синтаксис

myFormValidator.getAllAdviceMessages(field[, force]);

Аргументи

1. field - (mixed) Рядок з id або посилання Element або Element на поле вводу
2. force - (boolean; опціонально) якщо false, повідомлення не повертаються, якщо поле вводу має рядок 'ignoreValidation' у своєму властивості data-validators

Повертає

• (object) Об'єкт, що містить інформацію про повідомлення. Див. приклад:

  {
      message: string, //The message the user would see
      warnOnly: boolean, //true if this should just be a warning
      passed: boolean, //true if the current value passes validation
      validator: validator //the InputValidator instance
  }
  

Метод Form.Validator: getAdvice

Отримує повідомлення поради для поля та заданої назви валідатора.

Синтаксис

myFormValidator.getAdvice(field, validatorName);

Приклад

myFormValidator.getAdvice(myInput, 'validate-email');

Аргументи

1. field - (mixed) Рядок з id або посилання Element або Element на поле вводу.
2. validatorName - (string) Рядок, що представляє ім'я валідатора, як воно було додано до Form.Validator.

Повертає

• (element) DOM-елемент, що містить повідомлення для користувача.