действие

Необязательное, по умолчанию false.

Используйте это, чтобы включить в всплывающее окно таблицу стилей, которая сделает его внешний вид согласованным с пользовательским интерфейсом браузера и с другими надстройками, использующими свойство browser_style. Хотя этот ключ по умолчанию false, рекомендуется включать его и устанавливать значение true для согласованности внешнего вида всплывающих окон с остальной частью пользовательского интерфейса браузера.

В Firefox таблицу стилей можно увидеть по адресу chrome://browser/content/extension.css или chrome://browser/content/extension-mac.css на macOS. При установке размеров обратите внимание, что этот лист стилей в настоящее время устанавливает box-sizing: border-box (см. box-sizing).

Стили браузера описывает классы, которые вы можете применять к элементам во всплывающем окне, чтобы получить определённые стили.

Надстройка-пример latest-download использует browser_style во всплывающем окне.

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

• "navbar": кнопка размещается в основной панели инструментов браузера рядом с адресной строкой.
• "menupanel": кнопка размещается в всплывающей панели.
• "tabstrip": кнопка размещается в панели инструментов, содержащей вкладки браузера.
• "personaltoolbar": кнопка размещается в панели закладок.

Это свойство поддерживается только в Firefox.

Это свойство необязательное и по умолчанию равно "menupanel".

Firefox запоминает настройку default_area для надстройки, даже если она была удалена и затем повторно установлена. Чтобы заставить браузер принять новое значение для default_area, необходимо изменить идентификатор надстройки.

Надстройка не может изменить расположение кнопки после её установки, но пользователь может переместить кнопку с помощью встроенного механизма настройки пользовательского интерфейса браузера.

Используйте это для указания одного или нескольких значков для действия. Значок отображается в панели инструментов браузера по умолчанию.

Значки задаются как URL-адреса, относительные к файлу manifest.json.

Вы можете указать один значок, передав сюда строку:

"default_icon": "path/to/geo.svg"

Чтобы указать несколько значков разных размеров, передайте сюда объект. Имя каждой свойства — высота значка в пикселях, которое должно быть преобразуемо в целое число. Значение — URL-адрес. Например:

    "default_icon": {
      "16": "path/to/geo-16.png",
      "32": "path/to/geo-32.png"
    }

Нельзя указывать несколько значков одинакового размера.

См. Выбор размеров значков для получения дополнительных сведений.

Путь к файлу HTML, содержащему описание всплывающего окна.

Файл HTML может содержать CSS и JavaScript-файлы с использованием элементов <link> и <script>, как и обычная веб-страница. Однако <script> должен иметь атрибут src для загрузки файла. Не используйте <script> со встроенным кодом, так как у вас возникнет запутанная ошибка политики нарушения содержимого.

В отличие от обычной веб-страницы, JavaScript, выполняющийся во всплывающем окне, может получать доступ ко всем API веб-расширений (при условии, что надстройка имеет соответствующие разрешения).

Это локазуемое свойство.

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

Это локазуемое свойство.

Это свойство позволяет указать разные значки для тем в зависимости от того, обнаруживает ли Firefox, что тема использует тёмный или светлый текст.

Если это свойство присутствует, это массив, содержащий по крайней мере один объект ThemeIcons. Объект ThemeIcons содержит три обязательных свойства:

"dark"

URL, указывающий на значок. Этот значок отображается, когда активна тема с тёмным текстом (такие как тема Firefox Light и тема по умолчанию, если не указан default_icon).

"light"

URL, указывающий на значок. Этот значок отображается, когда активна тема со светлым текстом (например, тема Firefox Dark).

"size"

Размер двух значков в пикселях.

Значки задаются как URL-адреса, относительные к файлу manifest.json.

Вы должны предоставить 16x16 и 32x32 (для дисплеев с повышенной плотностью пикселей) значки ThemeIcons.