V · 2022年08月12日 · 北京市

快速了解navigator API setAppBadge

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

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开发中也可以完美使用
推荐阅读
关注数
4194
内容数
887
SegmentFault 思否旗下人工智能领域产业媒体,专注技术与产业,一起探索人工智能。
目录
极术微信服务号
关注极术微信号
实时接收点赞提醒和评论通知
安谋科技学堂公众号
关注安谋科技学堂
实时获取安谋科技及 Arm 教学资源
安谋科技招聘公众号
关注安谋科技招聘
实时获取安谋科技中国职位信息