Window.openDialog()

在此页

句法
范例
注意事项
规范
浏览器兼容性
另请参阅
相关话题

非标
此特征是非标准的，且不在标准轨道中。不要在面向 Web 的生产站点中使用它：它不适用于每个用户。实现之间可能存在大的不兼容性，且行为将来可能改变。

window.openDialog() is an extension to window.open() . It behaves the same, except that it can optionally take one or more parameters past windowFeatures ，和 windowFeatures itself is treated a little differently.

The optional parameters, if present, are bundled up in a JavaScript 数组 object and added to the newly created window as a property named window.arguments . They may be referenced in the JavaScript of the window at any time, including during the execution of a load handler. These parameters may be used, then, to pass arguments to and from the dialog window.

调用 openDialog() returns immediately. If you want the call to block until the user has closed the dialog, supply modal 作为 windowFeatures parameter. Note that this also means the user won't be able to interact with the opener window until he closes the modal dialog.

句法

newWindow = openDialog(url, name, features, arg1, arg2, ...)

newWindow
url
名称: The window name (optional). See window.open() description for detailed information.
features: 见 window.open() 了解细节。
arg1 , arg2 , ...

范例

var win = openDialog("http://example.tld/zzz.xul", "dlg", "", "pizza", 6.98);

注意事项

New features

all - Initially activates (or deactivates ("all=no") ) all chrome (except the behavior flags chrome , dialog and modal ). These can be overridden (so "menubar=no,all" turns on all chrome except the menubar.) This feature is explicitly ignored by window.open() . window.openDialog() finds it useful because of its different default assumptions.

Default behavior

chrome and dialog features are always assumed on, unless explicitly turned off (" chrome=no "). openDialog() treats the absence of the features parameter the same way window.open() does; that is, an empty string sets all features to off) except chrome and dialog , which default to on. If the features parameter is a zero-length string, or contains only one or more of the behavior features ( chrome , dependent , dialog and modal ) the chrome features are assumed "OS' choice." That is, window creation code is not given specific instructions, but is instead allowed to select the chrome that best fits a dialog on that operating system.

Passing extra parameters to the dialog

To pass extra parameters into the dialog, you can simply supply them after the windowFeatures parameter:

openDialog("http://example.tld/zzz.xul", "dlg", "", "pizza", 6.98);

The extra parameters will then get packed into a property named arguments 类型 数组 , and this property gets added to the newly opened dialog window.

To access these extra parameters from within dialog code, use the following scheme:

var food  = window.arguments[0];
var price = window.arguments[1];

Note that you can access this property from within anywhere in the dialog code. ( Another example ).

Returning values from the dialog

由于 window.close() erases all properties associated with the dialog window (i.e. the variables specified in the JavaScript code which gets loaded from the dialog), it is not possible to pass return values back past the close operation using globals (or any other constructs).

To be able to pass values back to the caller, you have to supply some object via the extra parameters. You can then access this object from within the dialog code and set properties on it, containing the values you want to return or preserve past the window.close() 操作。

var retVals = { address: null, delivery: null };
openDialog("http://example.tld/zzz.xul", "dlg", "modal", "pizza", 6.98,
    retVals);

If you set the properties of the retVals object in the dialog code as described below, you can now access them via the retVals array after the openDialog() call returns.

Inside the dialog code, you can set the properties as follows:

var retVals = window.arguments[2];
retVals.address  = enteredAddress;
retVals.delivery = "immediate";

规范

This is not part of any specification.

浏览器兼容性

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`openDialog` 非标	Chrome No	Edge No	Firefox No	IE ?	Opera ?	Safari ?	WebView Android No	Chrome Android No	Firefox Android No	Opera Android ?	Safari iOS ?	Samsung Internet Android No

图例

不支持
兼容性未知 ?
非标。预期跨浏览器支持较差。

另请参阅

Another example
window.importDialog (mobile)

元数据

最后修改： Feb 22, 2020

在此页

句法

范例