Документация для разработчиков
Темная тема

BX24.openApplication

void BX24.openApplication([
	Object parameters[,
	Function closeCallback
	]
]);

При вызове метода будет открыто всплывающее окно с фреймом приложения. Приложению будут переданы данные из параметра parameters. При закрытии всплывающего окна будет вызван обработчик closeCallback. Метод может контролировать размеры, заголовок, и лейбл сладера.

Параметры

ПараметрОписание
parameters Объект с параметрами, которые будут переданы открываемому приложению в виде JSON-строки
closeCallback Обработчик закрытия приложения
bx24_width Ширина слайда
bx24_label Заголовок плашки
bx24_title Заголовок страницы
bx24_leftBoundary Слайдер во всю ширину с отступом слева. Не может быть одновременно с bx24_width.

Для плейсментов CRM_*_LIST_MENU заблокировано.

Примеры

Единый пример для BX24.openApplication и BX24.closeApplication

<script src="//api.bitrix24.com/api/v1/"></script>
<?
// разбор входных данных
$placementOptions = array();
if(array_key_exists('PLACEMENT_OPTIONS', $_REQUEST))
{
	$placementOptions = json_decode($_REQUEST['PLACEMENT_OPTIONS'], true);
}

// если приложение не развернуто, выводим кнопку открытия, в противном случае закрытия
if(!isset($placementOptions['opened']))
{
?>
	<span onclick="openApplication()">Open</span>
<?
}
else
{
?>
	<span onclick="closeApplication()">Close</span>
<?
}

?>
<script>
	function openApplication()
	{
		BX24.openApplication(
			{
				'opened': true // данные, передаваемые открываемому приложению
			},
			function()
			{
				// этот обработчик сработает, когда приложение будет закрыто
				alert('Application closed!')
			}
		);

		setTimeout(closeApplication, 15000); // автоматически закрыть через 15 секунд
	}

	function closeApplication()
	{
		BX24.closeApplication();
	}
</script>

Пример со слайдером

BX24.openApplication(
	{
		'opened': true,
		'bx24_width': 450,// int
		'bx24_label': {
			'bgColor':'pink', // aqua/green/orange/brown/pink/blue/grey/violet
			'text': 'my task',
			'color': '#07ff0e',
		},
		'bx24_title': 'my title', // str
		//'bx24_leftBoundary': 300, //int
	},
	function()
	{
		console.log('Application closed!')
	}
);


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
1
Дмитрий Салтановский
Сообщение не промодерировано, возможны ошибки и неточности.
Если приложение статичное, без бекэнда, т.е. на чистом Html и JS, для определения, открыто ли оно через BX24.openApplication следует передать какой-либо флаг при вызове BX24.openApplication(), а в самом аппе проверить наличие этого флага в BX24.placement.info().
© «Битрикс», 2001-2024, «1С-Битрикс», 2024