图标

类型 数组

icons 成员指定一个对象数组,表示可以作为不同上下文中的应用程序图标的图像文件。例如,它们可以用来在其他应用程序列表中表示 Web 应用程序,或将 Web 应用程序与操作系统的任务切换器和/或系统偏好设置集成。

示例

json
"icons": [
  {
    "src": "icon/lowres.webp",
    "sizes": "48x48",
    "type": "image/webp"
  },
  {
    "src": "icon/lowres",
    "sizes": "48x48"
  },
  {
    "src": "icon/hd_hi.ico",
    "sizes": "72x72 96x96 128x128 256x256"
  },
  {
    "src": "icon/hd_hi.svg",
    "sizes": "any"
  }
]

图像对象可能包含以下值

成员 描述
sizes 一个字符串,包含使用与 sizes 属性相同的语法表示的空间分隔的图像尺寸。
src 图像文件的路径。如果 src 是一个相对 URL,则基 URL 将是清单的 URL。
type 关于图像媒体类型的提示。此成员的目的是允许用户代理快速忽略它不支持的媒体类型的图像。
purpose

定义图像的目的,例如如果图像旨在在主机操作系统的上下文中服务于一些特殊目的(即,为了更好地集成)。

purpose 可以包含以下一个或多个值,用空格隔开

  • monochrome: 用户代理可以在需要 具有实心填充的单色图标 的地方显示此图标。图标中的颜色信息将被丢弃,只有 alpha 数据将被使用。然后,用户代理可以像在任何实心填充上使用蒙版一样使用图标。
  • maskable: 该图像是在 图标蒙版和安全区域 的前提下设计的,因此,用户代理可以安全地忽略和屏蔽安全区域之外的图像的任何部分。
  • any: 用户代理可以自由地在任何上下文中显示图标(这是默认值)。

规范

规范
Web 应用清单
# icons-member

浏览器兼容性

BCD 表格仅在浏览器中加载