Открыть слайдер со своим интерфейсом
Зачастую, в своих приложениях возникает необходимость открыть некий попап для взаимодействия с пользователем. Это может быть попап-окно, в котором хочется показать
- настройки опций приложения,
- какой-то диалог с пользователем,
- детальную информацию о документе, товаре и т.д.
Это легко сделать, однако важно помнить, что интерфейс приложения показывается внутри фрейма. А значит, любой контент, который вы показываете, ограничен размерами фрейма. Появление попап-окна больших размеров вызовет появление скроллбара на фрейме, что не всегда удобно и, однозначно, не красиво.
Для решения этой проблемы вам предлагается использовать слайдер. Слайдер — это попап-окно, которое открывается поверх фрейма и позволяет вам показать любой контент, не ограничиваясь размерами изначального фрейма приложения. Интерфейс самого Битрикс24 построен на использовании слайдеров, и вы можете использовать их в своих приложениях.
Пример
<script>
BX24.openApplication(
{
'action': 'display_setting' // ваши произвольные данные, передаваемые приложению для отображения в слайдере
},
function()
{
// этот обработчик сработает, когда слайдер будет закрыт
alert('Application closed!')
}
);
</script>
Вы сами решаете, какие параметры вы хотите передать вашему приложению для того, чтобы на стороне приложения сформировать нужный контент/интерфейс для слайдера. В примере выше мы передаем в приложение параметр action со значением display_setting. Получив POST-запрос от Битрикс24 и обработав этот параметр , приложение может сформировать интерфейс с какими-то пользовательскими настройками, вместо того чтобы показать интерфейс приложения по умолчанию.
Запрос будет приходить на тот же URL, который вы указали в настройках вашего приложения в поле Путь вашего обработчика, в случае локального приложения, или в поле Ссылка на приложение, в случае тиражного.
Иными словами, ваш код, который отвечает по данному URL, должен выступать в качестве некого контроллера или менеджера, формирующего разные html в зависимости от параметров, которые приходят в запросе.
Преимущества использования слайдера
- Красиво. Слайдеры в Битрикс24 — это стандартный способ показа контента, и пользователи привыкли к ним.
- Удобно. Слайдеры позволяют показывать контент любого размера, не ограничиваясь размерами фрейма приложения, в отличие от попап-окон.
- Просто. Понять, какой интерфейс нужно вернуть в слайдер, не составит труда, это реализуется простым условием в вашем коде.
- Гибко. Вы сами решаете, какой контент показывать в слайдере, и можете менять его в зависимости от параметров, переданных в запросе.