侧边栏

A sidebar is a pane that is displayed at the 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. For example, Firefox has a "View > Sidebar" menu. Only one sidebar can be shown at a time, and that sidebar will be displayed for all tabs and all browser windows.

The browser may include a number of built-in sidebars. For example, Firefox includes a sidebar for interacting with bookmarks:

Using the sidebar_action manifest.json key, an extension can add its own sidebar to the browser. It will be listed alongside the built-in sidebars, and the user will be able to open it using the same mechanism as for the built-in sidebars.

就像浏览器的弹出页面，侧边栏也是一个 HTML 文档。当用户打开侧边栏时，HTML 文档载入打开的浏览器窗口。每个窗口有一个该文档的实例。打开一个新窗口时，该窗口获得自己的文档实例

可以使用函数sidebarAction.setPanel() (en-US)指定侧边栏仅用于指定的某个标签，使用windows.getCurrent() (en-US) 侧边栏知道自己属于哪一个标签。

// sidebar.js
browser.windows.getCurrent({populate: true}).then((windowInfo) => {
  myWindowId = windowInfo.id;
});

不同的窗口使用不同的侧边栏是非常有用的，这是一个实例，见"annotate-page" example.

侧边栏俱有和后台程序以及弹出窗口相同的 API 权限，在非隐藏模式下，侧边栏使用 API runtime.getBackgroundPage() (en-US) 可以直接访问后台页面，使用 API 如tabs.sendMessage() 与 content scripts 交互，使用 API 如 runtime.sendNativeMessage() 与原生应用交互。

关闭窗口或关闭侧边栏时，侧边栏文档退出。这意味着和后台页面不同，侧边栏文档不是一直住留，也不像弹出窗口，只要用户与页面交互，它就一直存在。

使用侧边栏的扩展载入时，侧边栏自动打开。这是为了帮助用户知道扩展俱有侧边栏。注意不能通过编程的方式打开侧边栏：侧边栏只能由用户打开。