Формы в блоках

Выберите инструмент для разработки с AI-агентом:

  • используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
  • используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации

Формы в блоках работают через subtype: form. Подтип подготавливает блок для встраивания CRM-формы и добавляет настройки формы в редакторе.

Что нужно для работы блока

В манифесте блока укажите subtype: form, а в разметке добавьте ноду .bitrix24forms.

Минимальный пример:

'block' => [
            'subtype' => 'form',
        ],
        'assets' => [
            'ext' => [
                'landing_form',
            ],
        ],
        
<div class="bitrix24forms" data-b24form-use-style="Y"></div>

В штатных блоках расширение landing_form указывают в манифесте. Если его нет, подтип добавит его автоматически.

Как подтип настраивает блок

При подготовке манифеста подтип:

  • подключает расширение landing_form
  • добавляет для .bitrix24forms настройку стиля crm-form
  • добавляет в редакторе настройки формы для ноды .bitrix24forms

В Битрикс24 в настройках блока появляется ссылка на страницу с формами.

В публичной части и при публикации система заменяет маркер формы на рабочий код встраивания.

Что происходит после добавления блока

После добавления блока система проверяет ноду .bitrix24forms.

  • если в разметке нет .bitrix24forms, автоматическая настройка не выполнится
  • если у блока уже выбрана форма, система сохранит ее
  • если форма еще не выбрана, система попробует подставить готовую форму и при необходимости создаст новую
  • после этого система записывает выбранную форму в атрибут data-b24form

Внутри блока форма сохраняется как маркер вида #crmFormInline<ID>.

Что проверить перед использованием

  • нода .bitrix24forms должна уже быть в разметке блока
  • стили формы в актуальных штатных блоках задаются через data-b24form-design и data-b24form-use-style
  • набор настроек в редакторе зависит от того, есть ли в Битрикс24 доступные формы
  • старые элементы .landing-block-form-styles и атрибут data-b24form-show-header относятся к миграции старого формата и для новых блоков не нужны
  • подтип form может использоваться и в комбинированных блоках, например вместе с map

Примеры штатных блоков

  • 33.1.form_1_transparent_black_left_text
  • 33.10.form_2_light_left_text
  • 33.23.form_2_themecolor_no_text
  • 66.90.form_new_default

Чтобы форма работала корректно, добавьте ноду .bitrix24forms и укажите subtype: form в манифесте.

Продолжите изучение

Предыдущая
Формы поиска
Следующая
Обзор блоков