Закрыть окно с приложением BX24.closeApplication
Выберите инструмент для разработки с AI-агентом:
- используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
- используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации
BX24.closeApplication(callback?: callable): void;
Метод BX24.closeApplication закрывает окно, в котором Битрикс24 показывает приложение поверх страницы. Такое окно выезжает справа, как слайдер, и его открывает метод BX24.openApplication. Метод пригодится и в местах встраивания, которые открывают приложение в слайдере, например в пункте меню списка CRM. В окне можно добавить кнопку, которая его закрывает.
Закрыть окно может и приложение, которое его открыло: оно тоже вызывает BX24.closeApplication в своем фрейме.
Метод работает только внутри фрейма приложения в Битрикс24. Вызывайте его после инициализации библиотеки в обработчике BX24.init. Собственный scope методу не нужен: он управляет интерфейсом, а не обращается к REST API.
Параметры метода
|
Название |
Описание |
|
callback |
Библиотека принимает параметр, но Битрикс24 эту функцию не вызывает. Как узнать о закрытии окна, описано в разделе Обработка ответа |
Пример кода
Как использовать примеры в документации
Закрыть окно по кнопке:
<button id="close-window">Закрыть</button>
<script>
BX24.init(function () {
document.getElementById('close-window').addEventListener('click', function () {
BX24.closeApplication();
});
});
</script>
Пример, в котором приложение открывает себя в окне и закрывает его, есть на странице BX24.openApplication.
Обработка ответа
Метод не возвращает данные (void). Узнать о закрытии окна может приложение, которое его открыло: Битрикс24 вызовет функцию closeCallback, переданную в BX24.openApplication. Она получает один параметр — пустой массив [].
Обработка ошибок
Кодов ошибок метод не возвращает.
|
Ситуация |
Что происходит |
Что делать |
|
Окно приложения не открыто: приложение работает на своей странице в Битрикс24 и окно не открывало |
Ничего не происходит |
Показывать кнопку закрытия, только когда приложение открыто в окне. Например, передать признак окна в параметре |
|
Поверх окна приложения открыт другой слайдер, например страница из BX24.openPath |
Ничего не происходит: метод закрывает только верхний слайдер и только если это окно приложения |
Дождаться, пока пользователь закроет верхний слайдер |
|
Код ждет вызова |
Функция не вызывается |
Выполнить нужный код в |