快速了解navigator API setAppBadge

960 阅读3分钟

欢迎关注我的公众号:前端侦探

在很多客户端应用程序中,一般会通过应用图标的角标来显示当前消息的数量,例如

image-20220727163054766

其实,web 中也有类似的设定,花两分钟了解一下吧

一、navigator.setAppBadge

现在的navigator早已不是以前的navigator了,印象中的navigator通常用于获取设备的信息,浏览器发展这么多年,现在navigator也赋予了很多原生底层的能力,比如今天要讲到的设置应用图标徽章的能力,navigator.setAppBadge

语法很简单,如下

navigator.setAppBadge(?contents);

这里的contents表示要设置的数字,不是必填的。

如果你随便打开一个网页,然后在控制台执行

navigator.setAppBadge(33);

但是并不会有什么变化

image-20220727164534668

原因其实很简单,这时的 Chrome浏览器图标并不是该网站的应用图标,解决方式有两种

首先如果是普通的网站,比如刚才的 MDN官网,需要将该网站创建快捷方式

image-20220727164934289

这样,MDN 官网也有了自己的应用图标

image-20220727165256789

现在重新在控制台执行以上代码

image-20220727165433838

这样应用图标上就有数字提示了,和普通的应用程序完全一样

还有另外一种方式,现在有一些PWA应用,体验会更好,可以离线使用,比如vue3官网,右上角会提示“安装应用”

image-20220727165952065

安装后打开,然后在控制台执行以上代码

image-20220727170332455

同样可以支持数字展示

二、不同参数的细节

前面提到,参数不是必须的,比如不传参数

navigator.setAppBadge();

此时表示数量是不确定的,在 Mac OS 下的表现是这样的,一个红色圆圈

image-20220727171227012

在 windows 下,有磁贴和图标两种展现形式

image-20220727171520646

参数支持的格式是BigUint64Array,简单来说就是非负整数

navigator.setAppBadge(3);

实测小数、数字类型的字符串也是支持的

navigator.setAppBadge('3.5');

image-20220727172226287

windows 系统表现如下

image-20220727172841170

如果为0,则会清除标识

navigator.setAppBadge(0);

还有一个现象,如果超过 99,则展示为99+

navigator.setAppBadge(100);

image-20220727172503316

windows 系统表现如下(磁贴居然没有数字了)

image-20220727173121564

三、electron 中的应用

事实上,目前支持PWA的网站是少之又少,大多数人也没有将网站快捷方式另存的习惯,所以实际生产中几乎没有setAppBadge的用武之地。

不过,如果你有开发electron的需求,不妨试一下这个方法,完美支持应用图标通知提示

image-20220727184821263

相比electron原生的方法好处是,可以直接在渲染进程使用,无需通信

四、总结和说明

以上就是全部内容了,你学会了吗?下面总结一下要点

  1. navigator 现在很强大,支持了很多原生底层的功能
  2. navigator.setAppBadge 可以用来设置应用图标徽章,也就是右上角的红色数字角标
  3. 浏览器图标并不是该网站的应用图标,需要将网站单独设置快捷方式
  4. navigator.setAppBadge 传入参数为空时,表现为一个圆圈,表示未知数字,参数为0时,会清除角标,参数大于99时,会展示为99+
  5. 实际情况下几乎很少使用,毕竟国内支持PWA网站不多
  6. electron开发中也可以完美使用

navigator下面还有很多方法,都是和原生底层相关的,比如关于剪贴板的(Navigator.clipboard),还有可以调用系统原生分享的(Navigator.share)等等,这些 API会让 web 看起来更加原生,很多以前需要用到客户端sdk的能力也在慢慢支持,相信会越来越好的。最后,如果觉得还不错,对你有帮助的话,欢迎点赞、收藏、转发❤❤❤

欢迎关注我的公众号:前端侦探