Библиотека для валидации, используемая для реализации логики проверки любых форм. Не имеет отношения к страницам, элементам управления или DOM-операциям, представляет собой только логическую часть.

Поскольку в библиотеке отсутствует часть, связанная со страницами, её можно использовать для реализации логики валидации элементов управления формами на различных платформах, таких как React Native, Weex и мини-программы WeChat. Это позволяет легко интегрировать библиотеку с шаблонами для создания сложных проверок форм.

Установка:

В среде Webpack:

npm install git://github.com/laden666666/my-validation --save

Затем просто используйте require для импорта:

var myValidation = require("my-validation");

Если вы работаете в веб-среде, просто импортируйте файл my-validation.js или my-validation.min.js с помощью тега script.

Использование:

Проверка объекта по правилам строки:

myValidation.validation(ruleStringString, valueString, isStringPath)

MyValidation.validation(ruleStringJson, values, isStringPath)

Примечание:

• Строка правил является основой для проверки. Формат — «имя правила1[параметр1, параметр2...] имя правила2[параметр1, парамтер2...]».
• Например, «required;minSize[5]» означает использование правила required для проверки на непустое значение, а затем использование правила minSize с параметром 5 для проверки длины строки, которая не должна быть меньше 5.
• В строке правил специальные символы «;» и «,» должны быть экранированы символами «;;» и «;,» соответственно.

Пример:

var result = myValidation.validation("required;sizeMax[16]", "test");

или:

var result = myValidation.validation({
    "user.name" : "required;sizeMax[16]",
},{
     user : {
          name : "test"
     }
},true)

Возвращаемый результат представляет собой массив результатов проверки правил.

Регистрация пользовательских правил:

myValidation.registerRule(name, validationFn, msg)

Пример:

myValidation.registerRule("minSize", function (value, object, count) {
    return !!value && value.length >= parseInt(count);
},function (value, object, count) {
    return "最少输入" + count + "个字符数";
});

или:

myValidation.registerRule("integer", function (value, object) {
    return !!value && /^[-+]?\d+$/.test(value);
}, "必须是整数");

Примечание:

• Функция проверки является основной частью процесса проверки формы. Её параметры включают:
  • value: проверяемое значение
  • object: объект проверки, включая исходное значение правила проверки
  • ...pram: параметры проверки, такие как xx[a,b,c], которые будут анализироваться как три параметра «a», «b» и «c»
• Если проверка не удалась, функция проверки должна вернуть false или вызвать myValidation.result для генерации возвращаемого результата. В противном случае проверка считается успешной.

Пользовательские сообщения об ошибках:

Иногда требуется динамически генерировать сообщения об ошибках во время проверки вместо использования сообщений по умолчанию. Для этого можно использовать следующий API:

myValidation.result (result, msg)

Например:

myValidation.registerRule("returnMsg", function () {
    return myValidation.result(false, "自定义错误提示");
}, "此为默认提示，会被覆盖掉");

Анализ результатов проверки:

Результаты проверки представляют собой массив ошибок или JSON-объект с ключом и значением, но невозможно сразу определить, была ли проверка успешной или нет. Можно либо перебирать каждый элемент проверки в поле result и сравнивать их с true, либо использовать функцию анализа:

myValidation.analyseResult (result)

Например:

var result = myValidation.validation({
    "user.name" : "required;sizeMax[16]",
},{
     user : {
          name : "test"
     }
},true);

result = myValidation.analyseResult(result) //result преобразуется в логическое значение

Библиотека стандартных правил проверки:

На данный момент предоставляется только несколько правил, которые автор планирует использовать немедленно. Другие правила могут быть зарегистрированы пользователями с помощью myValidation.registerRule.