徽章 API

Web 开发者经常更新文档的 favicon 或标题以指示状态。徽章 API 提供了一种更优雅的方式来显示状态，它提供了一种对用户代理有意义的方法，因此可以以与其余 UI 匹配的方式显示。

徽章有两种类型

• 文档徽章，通常显示在浏览器标签中，靠近或位于页面图标附近。
• 应用程序徽章，与已安装 Web 应用程序的图标相关联。这些徽章可能显示在应用程序图标上的停靠栏、架子或主屏幕上，具体取决于所使用的设备。

徽章可以具有三种可能的值之一，这些值是在内部设置的

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 说明