| 类型 |
对象
|
|---|---|
| Mandatory | No |
| 范例 |
|
A sidebar is a pane that is displayed at the left-hand side of the browser window, next to the web page. The browser provides a UI that enables the user to see the currently available sidebars and to select a sidebar to display.
The sidebar_action key enables you to define the default properties for the sidebar. You can change these properties at runtime using the
sidebarAction
API。
sidebar_action
key is an object that may have any of the properties listed below. The only mandatory property is
default_panel
.
| 名称 | 类型 | 描述 |
|---|---|---|
browser_style
|
布尔
|
Optional, defaulting to
true
.
Use this to include a stylesheet in your popup 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
chrome://browser/content/extension.css, or
chrome://browser/content/extension-mac.css on OS X. When setting
dimensions, be aware that this style sheet currently sets
Firefox Style Guide describes the classes you can apply to elements in the sidebar in order to get particular styles. |
default_icon
|
对象
or
字符串
|
Use this to specify one or more icons for the sidebar. The icon is
shown in the browser's UI for opening and closing sidebars.
Icons are specified as URLs relative to the manifest.json file itself. You can specify a single icon file by supplying a string here:
To specify multiple icons in different sizes, specify an object here. The name of each property is the icon's height in pixels, and must be convertible to an integer. The value is the URL. For example:
见 Choosing icon sizes for more guidance on this. This property is optional: if it is omitted, the sidebar doesn't get an icon. |
default_panel
|
字符串
|
The path to an HTML file that specifies the sidebar's contents.
The HTML file may include CSS and JavaScript files using
Unlike a normal web page, JavaScript running in the panel can access 所有 WebExtension APIs (subject, of course, to the extension having the appropriate permissions ). This property is mandatory. 这是 localizable property . |
default_title
|
字符串
|
Title for the sidebar. This is used in the browser UI for listing and
opening sidebars, and is displayed at the top of the sidebar when it
is open.
This property is optional: if it is omitted, the sidebar's title is
the extension's
这是 localizable property . |
open_at_install
|
布尔 |
Optional, defaulting to
true
. Determines whether the
sidebar should open on install. The default behavior is to open the
sidebar when installation is completed.
|
"sidebar_action": {
"default_icon": "sidebar.svg",
"default_title": "My sidebar!",
"default_panel": "sidebar.html",
"browser_style": true
}
For a simple example of an extension that uses a sidebar, see annotate-page .
BCD tables only load in the browser
最后修改： , 由 MDN 贡献者