MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

windows.create()

这篇翻译不完整。请帮忙从英语翻译这篇文章

创建一个新的窗口.

当你创建一个窗口时,你可以:

  • 加载一个或多个新的标签到该窗口中.
  • 将一个现有窗口的.标签移动到新的窗口中
  • 设置窗口的大小和位置
  • 创建一个面板样式的窗口,它没有浏览器的默认样式(地址栏,工具栏等)
  • 设置窗口的多种属性, 像是获得焦点或是为隐私窗口.

这是一个异步的方法返回一个 Promise.

语法

var creating = browser.windows.create(
  createData            // optional object
)

参数

createData可选
object.
url可选
字符串或字符串数组. 一个URL或都URL数组要在该窗口中打开成标签页的. 完整的需要包括scheme (像. http://www.google.com, not www.google.com). 相对路径将相对于该拓展中的当前页. 默认为打开新标签页.
tabId可选
integer. 如果设置了该值,将该tab从一个现有的窗口中移到新窗口中.
left可选
integer. 窗口左边到屏幕左边缘的距离.如果没有设定,新窗口将按上一个焦点窗口定位水平位置. 对于panel样式窗口,该值不起作用.
top可选
窗口顶部到屏幕的顶部距离.如果没有设定,新窗口将按上一个焦点窗口定位垂直位置. 对于panel样式窗口,该值不起作用.
width可选
integer. 新窗口的宽度, 包含框架. 未设定则使用默认宽度。.
height可选
integer. 新窗口的高度, 包含框架. 未设定则使用默认高度。.
focused可选
boolean.如果 为true, 新窗口将获取焦点. 否则新窗口当在后台打开并且当前焦点窗口继续保持焦点.。.默认为true
incognito可选
boolean. 是否打开为一个隐私窗口. 如果设定为隐私窗口并且引入了tabId, 则tabId对应的标签必须是一个隐私标签— 即不能把一个不是隐私标签的标签页移动到隐私窗口中。
type可选
windows.CreateType 值,表示创建窗口的类型. panel 或者popup 样式将打开一个没有默认浏览器样式的窗口 (地址栏,工具栏等)。
state可选
一个 windows.WindowState 值, 窗口的祲状态。 最小化、最大化、全屏状态不能与left, top, width, or height属性一起使用。

返回值

一个 Promise 其中传入一个包含新窗口细节的 windows.Window 对象。 这个windows.Window 有自己的tabs属性集 ,而不像 windows.get()返回的窗口对象和相似的API,  如果传递了populate项其仅仅包含tabs. 如果发生了错误 promise will be rejected with an error message.

浏览器兼容性

ChromeEdgeFirefoxFirefox for AndroidOpera
Basic supportYesYes45 1 2 3NoYes
tabIdYesNo45NoYes
state44Yes45No31
focusedYesYesNoNoYes
1. 'url' and 'tabId options can't both be set together.
2. 'url' does not accept relative paths.
3. The returned 'Window' object contains the 'tabs' property only from version 52 onwards.

示例

打开一个包含两个标签的窗口

function onCreated(windowInfo) {
  console.log(`Created window: ${windowInfo.id}`);
}

function onError(error) {
  console.log(`Error: ${error}`);
}

browser.browserAction.onClicked.addListener((tab) => {
  var creating = browser.windows.create({
    url: ["https://developer.mozilla.org",
          "https://addons.mozilla.org"]
  });
  creating.then(onCreated, onError);
});

当用户点击一个browser action打开一个窗口,并且将当前活跃的标签移动其中

function onCreated(windowInfo) {
  console.log(`Created window: ${windowInfo.id}`);
}

function onError(error) {
  console.log(`Error: ${error}`);
}

browser.browserAction.onClicked.addListener((tab) => {
  var creating = browser.windows.create({
    tabId: tab.id
  });
  creating.then(onCreated, onError);
});

打开一个小面板样式的窗口,并且加载一个本地包中的文件到其中

function onCreated(windowInfo) {
  console.log(`Created window: ${windowInfo.id}`);
}

function onError(error) {
  console.log(`Error: ${error}`);
}

browser.browserAction.onClicked.addListener((tab) => {

  var popupURL = browser.extension.getURL("popup/popup.html");

  var creating = browser.windows.create({
    url: popupURL,
    type: "popup",
    height: 200,
    width: 200
  });
  creating.then(onCreated, onError);

});

Example Add-ons

Acknowledgements

This API is based on Chromium's chrome.windows API. This documentation is derived from windows.json in the Chromium code.

Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.

文档标签和贡献者

 此页面的贡献者: Ruwind
 最后编辑者: Ruwind,