Установить заголовок страницы BX24.setTitle
Выберите инструмент для разработки с AI-агентом:
- используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
- используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации
BX24.setTitle(title: string, callback?: callable): void;
Метод BX24.setTitle меняет заголовок страницы Битрикс24 над фреймом приложения. Название вкладки браузера при этом не меняется.
Метод работает, только когда приложение открыто на своей странице в Битрикс24. В местах встраивания, например во вкладке карточки CRM, Битрикс24 команду не выполняет. Вызывайте метод после инициализации библиотеки в обработчике BX24.init. Собственный scope методу не нужен: он управляет интерфейсом, а не обращается к REST API.
Параметры метода
Обязательные параметры отмечены *
|
Название |
Описание |
|
title* |
Новый заголовок. Число библиотека превратит в строку |
|
callback |
Функция обратного вызова. Получает объект с новым заголовком (подробное описание) |
Пример кода
Как использовать примеры в документации
BX24.init(function () {
BX24.setTitle('Заявки за неделю', function (result) {
console.log('Новый заголовок:', result.title);
});
});
Обработка ответа
Метод не возвращает данные (void). Когда Битрикс24 обработает команду, он вызовет callback и передаст объект с новым заголовком:
{
"title": "Заявки за неделю"
}
Возвращаемые данные
|
Название |
Описание |
|
title |
Новый заголовок страницы |
Обработка ошибок
Кодов ошибок метод не возвращает.
|
Ситуация |
Что происходит |
Что делать |
|
Метод вызван в месте встраивания |
Заголовок не меняется, |
Показать заголовок в интерфейсе самого приложения |
|
Метод вызван в окне, которое открыл BX24.openApplication |
Меняется заголовок страницы под окном. У самого окна заголовка нет. |
Показать заголовок в интерфейсе самого приложения |
|
В |
Код приложения завершается ошибкой JavaScript |
Передать строку |