# Field
# Свойства
# form
Тип: Form
Форма, в которой находится поле.
# name
Тип: String
Название поля.
# type
Тип: String
TODO
# value
Тип: Разный
Значение поля. Тип данных зависит от поля.
- Если это текстовое поле, имя, телефон, почта, в значении строка.
- Если это галочка, то в значении
true
илиfalse
. - Если это список галочек, то в значении подобный объект:
{ "Вариант 1": true, "Вариант 2": false, "Вариант 3": true }
- Если это калькулятор, то в значении число, результат вычислений.
- Если это загрузка файла, то в значении массив с адресом загруженного файла или
null
, если файл не загружен. - Если поле не предполагает значения (поле-контейнер, поле-шаблон и тд), в значении
null
.
# uid
Тип: String
ID поля для интеграций.
# variable
Тип: String
Название переменной для калькулятора.
# hasCondition
Тип: Boolean
Есть ли у поля условие показа.
# isDisabled
Тип: Boolean
Является ли поле отключенным. Таковым оно может быть из-за условия показа или ручного отключения поля через field.disable()
.
# isRequired
Тип: Boolean
Является ли поле обязательным.
# Методы
# setValue
field.setValue(value)
Тип данных зависит от поля. Смотри свойство value
выше.
# disable
field.disable()
Отключает поле. Оно становится невидимым и не попадает в данные заявки.
# enable
field.enable()
Включает поле.
# addValidationRule
field.addValidationRule(cb, message)
Добавляет новое правило валидации для поля.
cb
— Функция, осуществляющая проверку. Значение поля передается первым аргументом. Возвращаетfalse
, если значение не прошло проверку.message
— Сообщение об ошибке в поле.
field.addValidationRule(function (value) {
if (value < 18) return false;
}, 'Вам должно быть не меньше 18!');
# removeValidationRule
field.removeValidationRule(cb)
Удаляет ранее добавленное правило валидации поля.
var cb = function (value) {
if (value < 18) return false;
};
// Добавляем правило
field.addValidationRule(cb, 'Вам должно быть не меньше 18!');
// Удаляем правило
field.removeValidationRule(cb);
# События
# change
Значение поля было изменено.
# disable
Поле стало неактивным.
# enable
Поле стало активным.
# Примеры
Поддержка в Telegram-чате
Подскажем, как решить вашу задачу!
Мы все еще дописываем документацию для разработчиков, поэтому нам важно, чтобы вы писали, что с чем возникают трудности, и какие еще возможности нужно добавить.