Подстроить размер фрейма под содержимое BX24.fitWindow
Выберите инструмент для разработки с AI-агентом:
- используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
- используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации
BX24.fitWindow(callback?: callable): void;
Метод BX24.fitWindow растягивает фрейм приложения на всю доступную ширину и подгоняет его высоту под содержимое страницы. Высоту метод берет из BX24.getScrollSize.
Метод работает только внутри фрейма приложения в Битрикс24. Вызывайте его после инициализации библиотеки в обработчике BX24.init и каждый раз, когда содержимое страницы выросло. Собственный scope методу не нужен: он управляет интерфейсом, а не обращается к REST API.
Параметры метода
|
Название |
Описание |
|
callback |
Функция обратного вызова. Получает объект с новым размером фрейма (подробное описание) |
Метод не уменьшает фрейм. Если содержимое страницы стало короче, фрейм останется прежней высоты: BX24.getScrollSize не возвращает высоту меньше видимой части фрейма. Чтобы уменьшить фрейм, передайте нужную высоту в BX24.resizeWindow.
Пример кода
Как использовать примеры в документации
BX24.init(function () {
BX24.fitWindow(function (size) {
console.log('Новый размер фрейма:', size.width, size.height);
});
});
Обработка ответа
Метод не возвращает данные (void). Когда Битрикс24 изменит размер фрейма, он вызовет callback и передаст объект с новыми шириной и высотой:
{
"width": 1108,
"height": 1579
}
Возвращаемые данные
|
Название |
Описание |
|
width |
Ширина фрейма в пикселях. Равна ширине области, в которой Битрикс24 показывает приложение |
|
height |
Высота фрейма в пикселях |
Обработка ошибок
Кодов ошибок метод не возвращает. Если Битрикс24 не выполнил команду, callback не вызывается. Так происходит в окне, которое открыл BX24.openApplication: высоту такого окна задает Битрикс24, а содержимое длиннее окна прокручивается внутри него. Ширину окна можно передать параметром width в settings при вызове BX24.openApplication.