fenyagg/citrus-validate

citrusValidator - jquery validator

citrusValidator

Внимание! Документация и примеры устарели! Для использования смотрите основной пример в index.html или ждите обновления.

Валидатор CitrusValidator jQuery Plugin

Пример использования citrusValidator

$(function() {
  var form = new citrusValidator($("#signupForm1"));
});

html:

<form id="signupForm1" method="post" action="">
    <div class="form-group">
        <label class="col-sm-4 control-label" for="firstname1">Телефон:<span class="red">*</span></label>
        <div class="col-sm-6 icon-container input-container">
            <input data-valid="phone required" type="text" class="form-control" name="phone" placeholder="99-99-99 или [phone]"/>
        </div>
    </div>
</form>

У каждого поля через data-valid="" указывается правила валидации через пробел.

Работа с плагином

Предустановленные правила валидации

• required - обязательное поле
• important - вызывает событие lockForm если поле не валидно и unlockForm если валидно
• phone - Все телефоны России. Пр. [phone] или 11-11-11
• phone_full - Федеральные номера России. Пр. [phone]
• ajax - post ajax запрос по пути data-ajax-url. Ответ строка с ошибкой
• email - Пр. [email protected]
• number - число + проверяет max, min параметры у поля
• main_password - поле для проверки confirm_password
• confirm_password - должен соответвовать main_password
• url - Пр. http://site.ru
• inn - ИНН юр и физ лица
• inn_u - ИНН юр лица
• inn_f - ИНН физ лица
• ogrn - ОГРН
• kpp - КПП

Все глобальные события, сообщения и правила устанавливаются через прототип (citrusValidator.prototype).

• _getMessage(messageName, arParams) - возвращает сообщение messageName отоформатированное массивом arParams или все сообщения если messageName пустое
• _setMessage(messageName, messageText) - Устанавливает сообщение
• _getRule(ruleName) - Получает правило ruleName или все правила если ruleName не задано
• _setRule(ruleName) - устанавливает правило ruleName
• _setRules(obRules) - устанавливает несколько правил
• _getEvent(eventName) - возвращает событие eventName или все события если eventName не задано
• _setEvent(eventName, fn) - устанавливает событие
• _setEvents(obEvents) - устанавливает несколько событий

Локальные через объект конструктора citrusValidator.

• getMessage(messageName, arParams) - возвращает сообщение messageName отоформатированное массивом arParams или все сообщения если messageName пустое
• setMessage(messageName, messageText) - Устанавливает сообщение
• getRule(ruleName) - Получает правило ruleName или все правила если ruleName не задано
• setRule(ruleName) - устанавливает правило ruleName
• setRules(obRules) - устанавливает несколько правил
• getEvent(eventName) - возвращает событие eventName или все события если eventName не задано
• setEvent(eventName, fn) - устанавливает событие
• setEvents(obEvents) - устанавливает несколько событий
• callEvent(eventName, arg) - вызывает событие и передает в него параметр

citrus-validate's Issues

Добавить возможность отложенной проверки

Нужно чтобы была небольшая задержка перед аякс проверкой поля. Как альтернатива строгого указания trigger: keyup.
Задержку нужно устанавливать в параметрах

Проверка полей группами через логику "и"

Добавить триггер init

Добавить метод destroy

нужно удалять объект валидатора и все события

Группы полей

Выводить все ошибки полей в 1 месте у группы.
Запускать проверку группы полей только после первого заполнения всех форм

Валидация полей в оформлении заказа работают не правлиьно

нужна возможность определять не валидное поле без текста ошибки

событие input для обработки событий автозаполнения

Нужна возможность устанавливать trigger для каждого правила

Тоесть поле trigger может быть строковым, может быть объектом.
Если объект то для каждого правила свой триггер.

Вобще желательно триггер вынести из параметров. Будет через data-valid-trigger="{}" или через validator.addField{ ... , trigger:{ "required": "submit", "length": "keyup" }}

Опция выводить ли ошибку к полю или нет

Проверка групп полей на required.

Через параметр require-group = "номер группы (int)"

Возможность проверки поля без создания объекта формы

через citrusValidator.proto