2.0.1 • Published 5 years ago

double-validate v2.0.1

Weekly downloads
17
License
-
Repository
github
Last release
5 years ago

Jquery Double Validate

Плагин для двойной валидации (client+server). Содержит в себе унифицированный ajax+json запрос и умеет автоматически подставлять ошибки к конкретным полям.

Установка:

npm install double-validate
bower install double-validate

Parameters

NameDescDefault
paramsПараметры транслируемые в JqueryFormValidator. Перекрывает параметры по умолчанию.{scrollToTopOnError: false, borderColorOnError: false, errorMessageClass: 'error', lang: 'ru', }
urlHandlerАдрес обработчика данной формы.Берет текущий action из формы.
showErrorMessageПоказывать ли alert при неуспешной попытке послать данные на серверtrue
errorMessageТекст для alert при неуспешной попытке послать данные на сервер (к примеру 5хх ответ сервера, отсутствие интернета)."Спасибо за отправку формы! Однако что-то пошло не так и мы не смогли получить данные. Перезвоните нам или попробуйте отправить еще раз "позже."
reportErrorToListenerПосылать ли данные об ошибки внешнему фиксатору. Нужно для личных нужд мониторинга работы форм.false
urlErrorListenerПосылать ли данные об ошибки внешнему фиксатору. Нужно для личных нужд мониторинга работы форм.null
classMainErrorContainerКласс контейнера куда будут складываться общие ошибки'double-validate__main-error-container'
classMainErrorItemКласс элемента в который будет обернут элемент общей ошибки'double-validate__main-error-item'

Callbacks

NameDesc
onServerValidateSuccessВызывается после успешной отправки данных на сервер и получении status=true. Принимает в параметр reponse json ответ сервера.
onServerValidateErrorВызывается после успешной отправки данных на сервер и получении status=false. Принимает в параметр reponse json ответ сервера.
onBlockedFormВызывается при блокировке формы перед отправкой данных на сервер. Принимает в параметр Jquery выборку текущей формы.
onUnBlockedFormВызывается после разблокировки формы. Принимает в параметр Jquery выборку текущей формы.
onErrorRequestВызывается при ошибке отправки формы. Принимает параметры запроса.

Детали

  • При отправке данных включает блокировку, не позволяя задублировать запрос до получения ответа. В этот момент на форму навешивается класс .double-validate--wait, для возможности дать визуальный фидбек юзверю.
  • При ошибке отправки запроса, или не получении в ответет корректного json, выведет примитивный alert с сообщением, которое можно заменить через параметр errorText
  • Учитывает файлы при отправке формы
  • Есть общие ошибки которые нет возможности логически привязать к какому либо полю, они передаются через отдельное свойство объекта ответа сервера. Они размещаются в отдельном контейнере, классами которые можно управлять через свойства.
  • Есть возможность послать на внешний сервер при ошибке отправки формы для внутренней системы алертов

Example

<form id="form" action="/ajax/formHandler.php">
	<div class="double-validate__main-error-container"></div>
	<input type="email" value="" placeholder="Email" required
		data-validation-error-msg-required="Поле, обязательно к заполнению"
		data-validation="required">

	<input type="text" value="" placeholder="Телефон" required
		data-validation-error-msg-required="Поле, обязательно к заполнению"
		data-validation="required">
</form>

<script src="bower_components/jquery/dist/jquery.min.js"></script>
<script src="bower_components/jquery-form-validator/form-validator/jquery.form-validator.min.js"></script>
<script src="bower_components/double-validate/jquery.double-validate.js"></script>
<script>
	$('#form').doubleValidate({
		onServerValidateSuccess: function(response){
			console.log('you request added');
		},
		onServerValidateError: function(response){
			console.log('error');
		}
	});
</script>

Унифицированный ответ сервера:

{
	  "status": true
	, "mainErrors": [
		"Вы уже отправили заявку"
	]
	, "errors": {
		  "email": "Пользователь с таким email уже существует"
		, "company": "Для регистрации в качестве оптового покупателя необходимо заполнить это поле"
		[...]
	}
}

Работает на основе jQuery Form Validator. Выбран он вместо стандартного jquery.validate.js из-за большей гибкости управления из html, что проще в поддержке на ряде движков.