An Options page enables you to define preferences for your extension that your users can change. Users can access the options page for an extension from the browser's add-ons manager:
The way users access the page, and the way it's integrated into the browser's user interface, will vary from one browser to another.
You can open the page programmatically by calling
runtime.openOptionsPage()
.
Options pages have a Content Security Policy that restricts the sources from which they can load resources, and disallows some unsafe practices such as the use of
eval()
。见
Content Security Policy
了解更多细节。
To create an options page, write an HTML file defining the page. This page can include CSS and JavaScript files, like a normal web page. This page, from the favourite-color example, includes a JavaScript file:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
</head>
<body>
<form>
<label>Favorite color</label>
<input type="text" id="color"/>
<button type="submit">Save</button>
</form>
<script src="options.js"></script>
</body>
</html>
JavaScript running in the page can use all the
WebExtension APIs
that the add-on has
permissions
for. In particular, you can use the
storage
API to persist preferences.
Package the page's files in your extension.
You also need to include the
options_ui
key in your manifest.json file, giving it the URL to the page.
"options_ui": {
"page": "options.html",
"browser_style": true
},
注意：
Google Chrome
and
Opera
使用
chrome_style
而不是
browser_style
, so if you wish to support them, you need to add both keys.
见
options_ui
page for
sharing options
between your options page and background or content scripts.
For details on how to design your options content to match the style of Firefox, see the Photon Design System and browser styles 文档编制。
webextensions-examples repository on GitHub includes the favourite-color example which implements options page features.
最后修改： , 由 MDN 贡献者