Bitrix JS в обвязке: компактная шпаргалка для админ‑ и интранет‑страниц

Зачем оставаться на платформенном слое

Готовый связующий код уменьшает количество внешних UI-библиотек в разделах, где уже есть стандартные скрипты из /bitrix/js/main/core/ — редакционная часть и сложные редакторские интерфейсы.

Готовность после формирования страницы

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

Пакеты и серверное объявление

Через CUtil::InitJSCore и аналоги подключают минимально достаточные наборы: окошки, общие утилиты, нужные элементы управления без лишнего общего массива в публичной витрине.

Вызовы на сервер

Фасад AJAX принимает маршрут, данные формы или JSON, задаёт режим транспортного уровня и обрабатывает ответ пользовательскими колбэками. Для чувствительных операций не забывают идентификатор сеансовой защиты в теле или заголовках.

Локализация текстов интерфейса

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

BX.ready(function () {
  BX.ajax({
    url: '/local/ajax/note.php',
    method: 'POST',
    dataType: 'json',
    data: { sessid: BX.bitrix_sessid(), action: 'ping' },
    onsuccess: function (data) {
      if (!data || !data.OK) {
        BX.UI.Notification.Center.notify({ content: BX.message('GENERIC_NOTICE') });
      }
    }
  });
});

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