action

可选，默认为 false。

定义了按钮最初放置在浏览器中的哪个部分。这是一个字符串，可以取以下四个值之一：

• "navbar"：按钮放置在主浏览器工具栏中，与 URL 栏相邻。
• "menupanel"：按钮放置在弹出面板中。
• "tabstrip"：按钮放置在包含浏览器标签页的工具栏中。
• "personaltoolbar"：按钮放置在书签工具栏中。

此属性仅在 Firefox 中受支持。

此属性是可选的，默认为 "menupanel"。

Firefox 会记住扩展程序的 default_area 设置，即使该扩展程序已被卸载并重新安装。要强制浏览器识别 default_area 的新值，必须更改扩展程序的 ID。

扩展程序安装后无法更改按钮的位置，但用户可能可以使用浏览器内置的 UI 自定义机制移动按钮。

使用此项指定一个或多个操作图标。默认情况下，图标显示在浏览器工具栏中。

图标指定为相对于 manifest.json 文件本身的 URL。

您可以通过在此处提供一个字符串来指定单个图标文件。

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

要指定不同尺寸的多个图标，请在此处指定一个对象。每个属性的名称是图标的像素高度，并且必须可转换为整数。值是 URL。例如：

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

您不能指定相同大小的多个图标。

有关此方面的更多指导，请参阅 选择图标大小。

包含弹出窗口规格的 HTML 文件的路径。

HTML 文件可以使用 <link> 和 <script> 元素包含 CSS 和 JavaScript 文件，就像普通网页一样。但是，<script> 必须具有 src 属性才能加载文件。请勿使用带有嵌入式代码的 <script>，否则您会收到令人困惑的内容违规策略错误。

与普通网页不同，在弹出窗口中运行的 JavaScript 可以访问所有 WebExtension API（当然，前提是扩展程序具有相应的 权限）。

这是一个 可本地化属性。

鼠标悬停在按钮上时显示的按钮工具提示。如果按钮被添加到浏览器的菜单面板，则该工具提示也会显示在应用程序图标下方。

这是一个 可本地化属性。

此属性使您能够为主题指定不同的图标，具体取决于 Firefox 检测到主题使用的是深色还是浅色文本。

如果存在此属性，它将是一个包含至少一个 ThemeIcons 对象的数组。ThemeIcons 对象包含三个必需属性：

"dark"

指向图标的 URL。当使用深色文本的主题（例如 Firefox Light 主题，以及未指定 default_icon 的 Default 主题）处于活动状态时，将显示此图标。

"light"

指向图标的 URL。当使用浅色文本的主题（例如 Firefox Dark 主题）处于活动状态时，将显示此图标。

"size"

两个图标的大小（以像素为单位）。

图标以相对于 manifest.json 文件的 URL 来指定。

您应该提供 16x16 和 32x32（用于视网膜显示屏）的 ThemeIcons。