图标

类型 对象
必填
清单版本 2 或更高版本

icons 键指定扩展的图标。这些图标将用于在附加组件管理器等组件中表示扩展。

它由以像素为单位的图像大小和相对于扩展根目录的图像路径的键值对组成。

如果未提供 icons,则默认情况下将使用标准扩展图标。

您应该至少提供一个主扩展图标,理想情况下大小为 48x48 像素。这是附加组件管理器中将使用的默认图标。但是,您可以提供任何大小的图标,Firefox 将尝试找到在不同组件中显示的最佳图标。

Firefox 在选择图标时会考虑屏幕分辨率。为了为使用高分辨率显示器(如视网膜显示器)的用户提供最佳视觉体验,请提供所有图标的两倍大小的版本。

示例

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

json
"icons": {
  "48": "icon.png",
  "96": "[email protected]"
}

SVG

您可以使用 SVG,浏览器会根据需要缩放您的图标。但是目前有两个需要注意的地方

  1. 您需要在图像中指定一个 viewBox。例如:
    html
    <svg
      xmlns="http://www.w3.org/2000/svg"
      viewBox="0 0 48 48"
      width="48"
      height="48">
      <!-- your svg content -->
    </svg>
    
  2. 即使您可以使用一个文件,您仍然需要在清单中指定各种尺寸的图标。例如:
    json
    "icons": {
      "48": "icon.svg",
      "96": "icon.svg"
    }
    

注意: 仅 Firefox 已知支持 SVG 图标。Chromium 有一个关于不支持的 SVG 图标的错误。

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

注意: 如果您使用 Inkscape 等程序创建 SVG,您可能需要将其另存为“纯 SVG”。Firefox 可能对各种特殊命名空间感到困惑,而不会显示您的图标。

浏览器兼容性

BCD 表格仅在浏览器中加载