ключ icons

Тип Object
Обязательный Нет
Пример
"icons": {
  "48": "icon.png",
  "96": "icon@2x.png"
}

Ключ icons определяет, какие иконки (значки) будет использовать ваше дополнение. Эти иконки будут использоваться при показе вашего дополнения в менеджерах компонентов, таких как Менеджер Дополнений.

Он содержит информацию вида ключ-значение со следующими данными: размер изображения в пикселях и путь к соответствующему изображению относительно директории, в которой содержится дополнение.

Если иконки не предоставлены с помощью этого ключа icons, вместо них будет использоваться стандартная иконка для расширений.

Вы должны указать по крайней мере одну главную иконку, в идеале размером 48х48 пикселей. Эта иконка будет использоваться по умолчанию в Менеджере Дополнений. Конечно, можно добавить иконки любого размера, и Firefox постарается найти лучшую из них для показа в разных компонентах.

Firefox учитывает разрешение экрана, когда выбирает иконку. Чтобы получить наилучший результат на мониторах с большим разрешением, использующих технологию Retina display, добавьте для каждой иконки версию с размерами в два раза больше.

Пример

Ключи в объекте icons определяют размеры иконок в пикселях, значения - относительный путь к файлам с изображениями. Этот пример содержит иконку размером 48х48 пикселей и увеличенную версию для мониторов высокого разрешения.

"icons": {
  "48": "icon.png",
  "96": "icon@2x.png"
}

SVG

В качестве иконки можно использовать файл SVG. Тогда браузер будет масштабировать иконку так, чтобы она подходила к компоненту, в котором она используется. Но есть два предостережения:

  1. В файле изображения должен быть определён viewBox. Например:
    <svg viewBox="0 0 48 48" width="48" height="48" ...
  2. Даже в том случае, если используется всего один файл, нужно определить его для разных размеров иконки в манифесте. Например:
    "icons": {
      "48": "icon.svg",
      "96": "icon.svg"
    }

Если вы используете программу Inkscape или подобную ей для создания SVG, сохраняйте изображение как "Простой SVG". Иначе Firefox может запутаться во множестве специальных пространств имён и не отобразить картинку.

Совместимость с браузерами

Update compatibility data on GitHub
КомпьютерыМобильные
ChromeEdgeFirefoxOperaFirefox для Android
iconsChrome Полная поддержка Да
Замечания
Полная поддержка Да
Замечания
Замечания Chrome does not support SVG format for icons. It is recommended to use PNG images.
Edge Полная поддержка 14Firefox Полная поддержка 48Opera Полная поддержка ДаFirefox Android Полная поддержка 48

Легенда

Полная поддержка  
Полная поддержка
Смотрите замечания реализации.
Смотрите замечания реализации.