Каждый PHP-разработчик, работающий с экосистемой Bitrix Framework, должен глубоко понимать работу её ключевых компонентов. В этой статье мы проведем подробный аудит темы «Открыть всплывающее окно BX24.openApplication», проанализируем лучшие практики и покажем, как правильно использовать открыть всплывающее в реальных задачах.

Открыть всплывающее окно BX24.openApplication

Тут может не хватать некоторых данных — дополним в ближайшее время

• не указаны типы параметров
• не указана обязательность параметров
• отсутствуют примеры
• отсутствует ответ в случае успеха
• отсутствует ответ в случае ошибки
• список параметров надо разбить скорее всего на отдельные таблицы

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

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

Входящие параметры и конфигурация метода

Для плейсментов 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!')
    }
);