Form

Все новые формы используют этот класс.

var form = page.getComponent('form-id');

Старые формы к этому классу не подключены.

Свойства

name

Версии API: 3.7 и выше

Тип: String

Название формы

isValid

Версии API: 3.7 и выше

Тип: Boolean

Правильно ли заполнены все поля.

isQuiz

Версии API: 3.7 и выше

Тип: Boolean

Является ли форма пошаговой.

fields

Версии API: 3.7 и выше

Тип: Field[]

Список всех полей формы.

Методы

recalculate

Версии API: 3.7 и выше

form.recalculate()

Запускает пересчет полей в форме-калькуляторе. Полезно, если в калькуляторе используются глобальные переменные, и нужно вызывать пересчет.

Замечание

Сам пересчет происходит с задержкой в несколько миллисекунд. Обновление формы не происходит синхронно.

setName

Версии API: 3.7 и выше

form.setName(name)

Изменяет имя формы, которое затем попадает в CRM.

reset

Версии API: 3.7 и выше

form.reset()

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

submit

Версии API: 3.7 и выше

form.submit()

Отправляет форму.

События

before-submit

Версии API: 3.7 и выше

Срабатывает после того, как форма успешно прошла валидацию, перед отправлением данных на сервер.

  • event.prevent() — Отменяет отправление формы.
  • event.fields — Массив полей формы, который можно модифицировать, например:
event.fields.push({
name: 'Ширина экрана',
value: window.innerWidth,
// ID для интеграций, не обязательный параметр
uid: 'screen-width',
});

submit

Версии API: 3.7 и выше

Форма успешно отправлена.

  • event.orderId — Номер заявки в личном кабинете Creatium
  • event.fields — Итоговый массив полей формы, с учетом всех изменений, которые могли быть сделаны в before-submit.

reset

Версии API: 3.7 и выше

Значения всех полей были сброшены к начальным, после успешной отправки заявки или после вызова form.reset().

before-step-change

Версии API: 3.7 и выше

Срабатывает перед изменением активного шага.

  • event.previousIndex — Номер предыдущего шага.
  • event.activeIndex — Номер нового активного шага.

step-change

Версии API: 3.7 и выше

Срабатывает после изменения активного шага.

  • event.previousIndex — Номер предыдущего шага.
  • event.activeIndex — Номер нового активного шага.