| 类型 |
对象
|
|---|---|
| Mandatory | No |
| 范例 |
|
使用
options_ui
key to define an
options page
for your extension.
The options page contains settings for the extension. The user can access it from the browser's add-ons manager, and you can open it from within your extension using
runtime.openOptionsPage()
.
You specify
options_ui
as a path to an HTML file packaged with your extension. The HTML file can include CSS and JavaScript files, just like a normal web page. Unlike a normal page, though, the JavaScript can use all the
WebExtension APIs
that the extension has
permissions
for. However, it runs in a different scope than your background scripts.
If you want to
share
data or functions between the JavaScript on your
options page
and your
background script(s)
, you can do so directly by obtaining a reference to the
Window
of your background scripts by using
extension.getBackgroundPage()
, or a reference to the
Window
of any of the pages running within your extension with
extension.getViews()
. Alternately, you can communicate between the JavaScript for your options page and your background script(s) using
runtime.sendMessage()
,
runtime.onMessage
, or
runtime.connect()
.
The latter (or
runtime.Port
equivalents) can also be used to share options between your
background script(s)
and your
content script(s).
In general, you will want to store options changed on option pages using the
storage API
to either
storage.sync()
(if you want the settings synchronized across all instances of that browser that the user is logged into), or
storage.local()
(if the settings are local to the current machine/profile). If you do so and your
background script(s)
(或
content script(s)
) need to know about the change, your script(s) might choose to add a listener to
storage.onChanged
.
options_ui
key is an object with the following contents:
| 名称 | 类型 | 描述 |
|---|---|---|
browser_style
可选 |
布尔
|
默认为
true
.
Use this to include a stylesheet in your page that will make it look
consistent with the browser's UI and with other extensions that use
the
In Firefox, the stylesheet can be seen at
Firefox Style Guide describes the classes you can apply to elements in the popup in order to get particular styles. |
open_in_tab
可选 |
布尔
|
默认为
false
.
若
|
page
|
字符串
|
Mandatory. The path to an HTML file containing the specification of your options 页面。
The path is relative to the location of
|
"options_ui": {
"page": "options/options.html"
}
BCD tables only load in the browser
最后修改： , 由 MDN 贡献者