icons

类型 Object
必填
Manifest 版本 2 或更高

icons 键用于指定扩展的图标。这些图标在诸如附加组件管理器 (about:addons) 等组件中代表该扩展。

该键由键值对组成,指定像素图像大小和相对于扩展根目录的图像路径。

如果未提供 icons,则会使用标准的扩展图标。

您应该提供一个扩展图标,最好是 32x32 像素大小。这是附加组件管理器中使用的默认图标。您可以提供任何尺寸的图标,Firefox 会选择最适合某个组件的图标。

Firefox 在选择图标时会考虑屏幕分辨率。为了给高分辨率显示器(如 Retina 显示器)的用户提供最佳视觉体验,请提供图标的双倍尺寸版本。

示例

icons 对象中的键指定像素图标大小,值指定相对图标文件路径。此示例包含一个 32 像素的扩展图标和一个用于高分辨率显示器的大版本。

json
"icons": {
  "32": "icon.png",
  "64": "icon@2x.png"
}

SVG

您可以使用 SVG,浏览器会相应地缩放您的图标。有两个注意事项:

  1. 您需要在图像中指定 viewBox,例如:

    html
    <svg
      xmlns="http://www.w3.org/2000/svg"
      viewBox="0 0 32 32"
      width="32"
      height="32">
      <!-- your svg content -->
    </svg>
    
  2. 即使您可以使用单个 SVG 文件,也需要在清单文件中指定图标大小,例如:

    json
    "icons": {
      "32": "icon.svg",
      "64": "icon.svg"
    }
    

注意:目前已知只有 Firefox 支持 SVG 图标。Chromium 有一个关于 不支持的 SVG 图标 的 bug。

注意:创建 SVG 时,请记住包含 xmlns 属性。否则,Firefox 将不会显示图标。

注意:使用 Inkscape 等程序创建 SVG 时,请将文件保存为“纯 SVG”。Firefox 不保证能处理特殊命名空间,并且可能无法显示包含它们的图标。

浏览器兼容性