Просмотров: 10140
Дата последнего изменения: 24.07.2020
Описание
Локальные уведомления используются для оповещения пользователя о каких-либо событиях, о протекании каких-либо процессов. Например, в интернет-магазине можно сообщать пользователю о смене статуса заказа, в чате можно показать новое сообщение от пользователя или оповестить о проблемах соединения с сервером.
Синтаксис
BXMobileApp.UI.NotificationBar(params);
Аргументы
Описание
params
Параметры уведомления:
message - текст сообщения;
contentType - тип текста сообщения:
html - переданный текст будет интерпретироваться как html (в режиме html распознаются только самые простейшие теги);
text - переданный текст будет интерпретироваться как text.
groupId - идентификатор группы;
color - цвет фона в формате hex (поддерживается альфа-канал);
textColor - цвет текста в формате hex (поддерживается альфа-канал);
loaderColor - цвет загрузчика в формат hex (поддерживается альфа-канал);
bottomBorderColor - цвет нижней границы панели уведомления формат hex (поддерживается альфа-канал);
indicatorHeight - высота иконки уведомления;
maxLines - максимальное число строк уведомления;
useLoader - флаг отображения загрузчика:
true - загрузчик отображается;
false - загрузчик не отображается.
imageURL - ссылка на изображение, которое будет использовано в качестве иконки;
iconName - название изображения в ресурсах приложения, которое будет использоваться в качестве иконки;
imageBorderRadius - радиус скругления изображения индикатора в процентах;
onTap - обработчик, который будет вызван, если пользователь нажмет на уведомление. Первым параметром в обработчик передается объект следующего формата:
extra - дополнительные данные, которые будут переданы в обработчики на onTap и onHideAfter. Произвольный js-объект.
isGlobal - флаг глобального уведомления. Глобальные уведомление всегда отображаются на видимом пользователем экране. Локальные уведомления отображаются только на странице, которая инициировала показ.
id - идентификатор уведомления.
Важно! Параметр groupId служит для объединения уведомлений в одну группу. Уведомления, принадлежащие одной группе, не могут одновременно отображаться на экране. Соответственно, если было создано уведомление А и Б с одинаковым groupId, то при показе уведомления А будет автоматически скрыто уведомление Б, если оно отображается в данный момент.
Пример. Уведомление с лоудером
// Уведомление с лоудером
var notifyBar = new BXMobileApp.UI.NotificationBar(
{
message: ‘Уведомление с лоудером’,
useLoader: true,
align:"center",
color: "#76088c",
autoHideTimeout:2000,
hideOnTap:true,
});
notifyBar.show(); //show - функция отображения панели уведомления.
notifyBar.hide(); //hide - функция скрытия панели уведомления.
Видео
iOS
Пример. Многострочное уведомление с картинкой
// Многострочное уведомление с картинкой
new BXMobileApp.UI.NotificationBar(
{
message: ‘Демо нотификационной панели. Панель можно увеличить, уменьшить, добавить иконку, картинку, загрузчик, поменять цвет фона и текста. Также можно изменить прозрачность от 0 до 100%’,
maxLines: 10,
contentType: 'html',
indicatorHeight:60,
autoHideTimeout:10000,
hideOnTap:true,
textColor:"#ffffff",
color:"#cc000000",
imageURL: dataPath+"/img/addition-icon.png"
}).show();