API оповещений

API оповещений предоставляет веб-разработчикам способ установки значка на документе или приложении в качестве уведомления о том, что состояние изменилось, не отображая более отвлекающие уведомления. Типичный пример использования — приложение с функцией обмена сообщениями, отображающее значок на значке приложения, чтобы показать, что новые сообщения поступили.

Веб-разработчики часто обновляют значки закладок или заголовки документов для указания состояния. API оповещений предоставляет более элегантный способ отображения состояния, предоставляя метод, который имеет смысл для пользователя и может поэтому отображаться таким образом, который соответствует остальной части пользовательского интерфейса.

Существует два типа значков:

• Значки документа, которые обычно отображаются в вкладке браузера рядом с или на значке страницы.
• Значки приложения, которые связаны с значком установленного веб-приложения. Они могут отображаться на значке приложения в доке, полке или на главном экране в зависимости от используемого устройства.

Значок может иметь одно из трех возможных значений, которые устанавливаются внутри:

nothing

Указывает, что в настоящее время значок не установлен. Значок может быть в этом состоянии из-за его очистки приложением или сброса пользовательским агентом.

flag

Указывает, что значок установлен, но не имеет конкретных данных для отображения. Значок будет в этом состоянии, если приложение установило значок, но не передало никакого значения в метод.

целое число

Значение, передаваемое при установке значка. Это значение никогда не будет 0, передача значения 0 при установке значка приведет к очистке значка пользовательским агентом, установив его в nothing.

Значок устанавливается с помощью методов setAppBadge() (для установленных приложений). Если эти методы не получают параметров, значение значка равно flag. Пользовательский агент отобразит значок уведомления, например, цветной круг на значке.

Эти методы также могут получить параметр contents, который должен быть числом. Затем это число будет отображаться как часть значка. Пользовательские агенты могут изменить это значение каким-либо образом. Например, если вы передадите очень большое число, например, 4000, пользовательский агент может отобразить его как 99+ в значке. Пользовательские агенты также могут проигнорировать эти данные и отобразить маркер вместо этого.

Значки очищаются с помощью методов clearAppBadge(). Эти методы не принимают параметров и устанавливают значение значка в nothing. Кроме того, передача значения 0 в setAppBadge() установит значение значка в nothing и очистит значок.

Нет.

Navigator.setAppBadge()

Устанавливает значок на значке, связанном с этим приложением.

Navigator.clearAppBadge()

Очищает значок на значке, связанном с этим приложением.

WorkerNavigator.setAppBadge()

Устанавливает значок на значке, связанном с этим приложением.

WorkerNavigator.clearAppBadge()

Очищает значок на значке, связанном с этим приложением.

Для установки значка уведомления на текущем приложении со значением 12:

navigator.setAppBadge(12);

Для очистки значка уведомления на текущем приложении:

navigator.clearAppBadge();

• Оповещения для значков приложений
• Описание API оповещений