Hooks

Что такое hooks?¶

Hooks в mxFormBuilder расширяют встроенные процессоры и позволяют настроить рендеринг формы или дополнительные действия после успешной отправки. Есть два типа. preHooks выполняются до рендеринга формы и меняют то, что парсер выводит на страницу. hooks вызываются после успешной отправки.

В обоих типах доступен полный объект формы mxFormBuilder. Вы можете менять его части и использовать ввод пользователя. Переменная по умолчанию: $hook, её вы используете в сниппете.

Как использовать¶

Сценариев применения hooks до и после обработки много. mxFormBuilder вызывает hooks в двух точках: preHooks и hooks. Первая точка: генерация полей для UI, параметр preHooks со строкой имён сниппетов через запятую. Каждый сниппет вызывается по порядку и должен вернуть true, иначе следующие сниппеты в списке не выполняются.

Hook: preHooks¶

Параметр preHooks задаёт сниппет, который выполняется до рендеринга полей формы. В hook можно изменить значения полей или полностью переписать HTML конкретного поля. Укажите имена сниппетов. В вызываемом сниппете используйте переменные $hook и $fields.

Hook: hooks¶

Как и preHooks, параметр hooks принимает список имён сниппетов через запятую. Сниппеты вызываются по порядку. Обработка продолжается, пока каждый возвращает true.

$fields: доступ к полям формы¶