Перейти к основному содержимому

Валидаторы

Валидаторы - набор правил, которые будут проверять содержимое атрибута при вводе в системе и отклонять добавление данных, если они не подходят под эти правила. Для каждого из полей атрибута вы можете настроить валидаторы. Этом можно сделать, если перейти в настройки поля атрибута и спуститься в секцию "Правила валидации".

Набор валидаторов может отличаться в зависимости от типа данных.

Типы валидаторов​

Каждый тип данных имеет свой набор доступных валидаторов. Ниже описаны все возможные валидаторы для всех типов данных, с которыми вы можете столкнуться.

Обязательное поле​

Это правило указывает, что данное поле обязательно должно быть заполнено. Не требует дополнительных настроек.

Обрезка пробелов вокруг входящих данных​

Это правило указывает, что пробелы в начале и в конце строки будут удалены. Не требует дополнительных настроек.

Проверка строки​

Это правило позволяет настроить параметры текстового типа. В дополнительных настройках можно указать фиксированную длину строки или задать диапазон с помощью минимального и максимального значения.

Проверка URL​

Это правило позволяет установить строковое значение, только если оно является ссылкой. Не требует дополнительных настроек.

Проверка на число​

Это правило проверяет, является ли значение числом. В дополнительных настройках можно указать, является ли число целым, а также установить минимальное и максимальное значение числа.

Округление числа​

Это правило не проверяет значение на числовой тип. Вместо этого оно выполняет округление числа по заданному в дополнительных настройках правилам. В дополнительных настройках вы можете указать порядок и правило округления числа.

Проверка Email​

Это правило проверяет, является ли значение строкой. Не требует дополнительных настроек.

Значение по умолчанию​

Это правило установит в атрибуте значение по умолчанию, если значение не было введено. В дополнительных настройках можно задать значение, которое будет установлено по умолчанию.

Проверка по заданному списку​

Это правило проверяет, соответствует ли вводимое значение в атрибут одному из значений, указанных в списке валидатора. В дополнительных можно задать значения через запятую, а также установить логическое отрицание.

Маска поля​

Это правило проверяет, соответствует ли вводимые данные значение маске. В дополнительных настройках можно задать маску с помощью спецсимволов.

Проверка по регулярному выражению​

Это правило проверяет, соответствует ли вводимые данные регулярному выражению. В дополнительных настройках можно задать регулярное выражение. Подробнее о регулярных выражениях вы можете узнать "тут".

Регулярное выражение

Несмотря на то, что вы можете добавлять несколько валидаторов на одно поле атрибута, валидация с помощью регулярного выражения не совместима с некоторыми другими типами валидации

Сравнение​

Это правило сравнивает значение указанного атрибута с другим, чтобы убедиться, что их соотношение соответствует сравнению, описанному в свойстве. В дополнительных настройках можно указать тип и значение сравнения, а также оператор сравнения.

Логический​

Это правило проверяет, является ли значение атрибута логическим. В дополнительных настройках можно настроить интерпретацию не булевых значений.

Размер​

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

Проверка файлов​

Это правило проверяет загруженный файл на соответствие параметрам. В дополнительных настройках можно настроить минимальное и максимальное значения единиц измерения веса файла, а также тип единиц измерения.

Пользовательские ошибки​

В каждый из валидаторов вы можете добавить текст ошибки. Этот текст будет видеть пользователь в случае, если валидатор не пропустит данные. Это можно сделать через настройки валидатора.

Примеры​

Пример валидации поля email.​

В этом примере строковое значение будет добавлено:

  • Удаление возможных пробелов вначале и в конце строки
  • Проверка, что строка является email

Пример валидации поля пароля.​

В этом примере строковое значение будет добавлено:

  • Проверка длины и состава строки с помощью регулярного выражения

Пример валидации поля изображения.​

В этом примере строковое значение будет добавлено:

  • Проверка размерность картинки
  • Проверка вес картинки
  • Пользовательские ошибка