icons

icons 鍵用於指定擴充套件的圖示。這些圖示在諸如附加元件管理器 (about:addons) 等元件中代表該擴充套件。

該鍵由鍵值對組成，指定畫素影像大小和相對於擴充套件根目錄的影像路徑。

如果未提供 icons，則會使用標準的擴充套件圖示。

您應該提供一個擴充套件圖示，最好是 32x32 畫素大小。這是附加元件管理器中使用的預設圖示。您可以提供任何尺寸的圖示，Firefox 會選擇最適合某個元件的圖示。

Firefox 在選擇圖示時會考慮螢幕解析度。為了給高解析度顯示器（如 Retina 顯示器）的使用者提供最佳視覺體驗，請提供圖示的雙倍尺寸版本。

示例

icons 物件中的鍵指定畫素圖示大小，值指定相對圖示檔案路徑。此示例包含一個 32 畫素的擴充套件圖示和一個用於高解析度顯示器的大版本。

json

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

您可以使用 SVG，瀏覽器會相應地縮放您的圖示。有兩個注意事項：

您需要在影像中指定 viewBox，例如：

html

<svg
  xmlns="http://www.w3.org/2000/svg"
  viewBox="0 0 32 32"
  width="32"
  height="32">
  <!-- your svg content -->
</svg>

注意：目前已知只有 Firefox 支援 SVG 圖示。Chromium 有一個關於不支援的 SVG 圖示的 bug。

注意：建立 SVG 時，請記住包含 xmlns 屬性。否則，Firefox 將不會顯示圖示。

注意：使用 Inkscape 等程式建立 SVG 時，請將檔案儲存為“純 SVG”。Firefox 不保證能處理特殊名稱空間，並且可能無法顯示包含它們的圖示。

本頁最後修改於 2025 年 7 月 17 日，作者為 MDN 貢獻者。