Действие на странице

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

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

В Firefox таблицу стилей можно найти в chrome://browser/content/extension.css, или chrome://browser/content/extension-mac.css на macOS.

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

Пример расширения latest-download использует browser_style в своём всплывающем окне.

Используйте это, чтобы указать иконку для действия.

Рекомендуется предоставить две иконки (19×19 пикселей и 38×38 пикселей) и указать их в объекте со свойствами, имеющими названия "19" и "38", например так:

    "default_icon": {
      "19": "geo-19.png",
      "38": "geo-38.png"
    }

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

Вы можете просто указать строку здесь:

"default_icon": "geo.png"

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

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

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

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

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

Подсказка для иконки, отображаемая при наведении курсора мыши на неё.

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

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

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

Например, рассмотрим значение:

"page_action": {
  "show_matches": ["https://*.mozilla.org/*"],
  "hide_matches": ["https://developer.mozilla.org/*"]
}

Это показывает действие на странице по умолчанию для всех HTTPS-адресов домена "mozilla.org", за исключением страниц в домене "developer.mozilla.org".

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

См. также hide_matches.

Необязательно. По умолчанию true.

Управляет тем, отображается ли действие на странице в адресной строке по умолчанию при установке расширения. Это свойство больше не поддерживается в Firefox 89.