Иконки
| Тип | Object |
|---|---|
| Обязательный | Нет |
| Версия манифеста | 2 или выше |
| Пример | "icons": { "48": "icon.png", "96": "icon@2x.png" } |
Ключ icons задаёт иконки для вашего расширения. Эти иконки будут использоваться для представления расширения в таких компонентах, как менеджер дополнений.
Он состоит из пар ключ-значение, где ключ — размер изображения в пикселях, а значение — путь к изображению относительно корневого каталога расширения.
Если icons не указан, по умолчанию будет использоваться стандартная иконка расширения.
Вы должны указать, по крайней мере, основную иконку расширения, желательно размером 48x48 пикселей. Это иконка по умолчанию, которая будет использоваться в менеджере дополнений. Однако вы можете указать иконки любого размера, и Firefox попытается выбрать лучшую иконку для отображения в разных компонентах.
Firefox будет учитывать разрешение экрана при выборе иконки. Для лучшего визуального опыта пользователей с высокоразрешающими дисплеями, такими как дисплеи Retina, предоставьте удвоенные версии всех ваших иконок.
Пример
Ключи в объекте icons указывают размер иконки в пикселях, значения — относительный путь к иконке. Этот пример содержит иконку расширения размером 48 пикселей и увеличенную версию для высокоразрешающих дисплеев.
"icons": { "48": "icon.png", "96": "icon@2x.png" }
SVG
Вы можете использовать SVG, и браузер будет масштабировать вашу иконку соответствующим образом. Однако в настоящее время есть два нюанса:
- Вам необходимо указать атрибут viewBox в изображении. Например:
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 48" width="48" height="48"> <!-- your svg content --> </svg>
- Несмотря на то, что вы можете использовать один файл, вам всё равно необходимо указывать различные размеры иконки в вашем манифесте. Например:
"icons": { "48": "icon.svg", "96": "icon.svg" }
Примечание: Известно, что только Firefox поддерживает SVG-иконки. В Chromium есть ошибка, связанная с неподдерживаемыми SVG-иконками.
Примечание: Не забудьте включить атрибут xmlns при создании SVG. В противном случае Firefox не сможет отобразить иконку.
Примечание: Если вы используете программу, такую как Inkscape, для создания SVG, вы можете сохранить её как "простой SVG". Firefox может быть сбит с толку различными специальными именованными пространствами и не отобразить вашу иконку.
Совместимость с браузерами
| Рабочий стол | Мобильные устройства | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | |
icons |
Да | Да | 48 | ? | Да | 14 | ? | ? | 48 | ? | 15 | ? |
svg_icons |
Нет | Нет | 92 | ? | Нет | 16.4 | ? | ? | 92 | ? | 16.4 | ? |
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/icons