niutech/ showModalDialog
Need help with showModalDialog?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.
About the developer
154 Stars 
90 Forks 
Apache License 2.0 
30 Commits 
16 Opened issues 
Description
window.showModalDialog polyfill using a <dialog> element
Services available
Readme
ShowModalDialog Polyfill
This is a
window.showModalDialog()shim using a modal HTML5 element and ECMAScript 2015 Generators or ECMAScript 2017 Async/Await. It was tested in the latest Google Chrome and in the latest Mozilla Firefox with the dom.dialog_element.enabled preference set to true in
about:config. Just include the following HTML code before using
showModalDialogfunction:
Passing both
window.dialogArgumentsand
window.returnValueis supported, provided that the dialog document is on the same server as the host document.
ShowModalDialog Polyfill is using Promises, Generators,
yield,
async,
awaitand the
spawnfunction by Jake Archibald. If they are unavailable, the polyfill is using
evaland JSON as a fallback, provided that statements are separated by new lines, the
showModalDialogfunction is not nested and runs only once in a function.
Please note that native
showModalDialogsupport is considered deprecated and it was removed from Chrome 43 and Firefox 56.
Syntax
spawn(function*() {
//statements before showing a modal dialog
var returnValue = yield window.showModalDialog( url [, arguments, options] );
//statements after closing a modal dialog
});
or:
(async function() {
//statements before showing a modal dialog
var returnValue = await window.showModalDialog( url [, arguments, options] );
//statements after closing a modal dialog
})();
or:
(function() {
//statements before showing a modal dialog
var returnValue = window.showModalDialog( url [, arguments, options] );
//statements after closing a modal dialog
})();
where:
- url - a string that specifies the URL of the document to load and display;
- arguments - a variant that specifies the arguments to use when displaying the document;
-
options - a string that specifies the dialog box style, using CSS or the following semicolon-delimited attributes:
dialogHeight:???px;dialogLeft:???px;dialogTop:???px;dialogWidth:???px;
When using generators or async/await, both
showModalDialogand
spawnfunctions are Promises, so you can use their
thenmethod and
yieldthem.
When using an
evalfallback, the
showModalDialogfunction throws an exception to stop executing code until the modal is closed, then it
evals the remaining code of a caller function.
In order to close the dialog from inside of it, invoke
parent.document.getElementsByTagName('dialog')[0].close(); provided that both documents have the same origin.
Demo
Here is a live demo. Works best in Google Chrome.
License
ShowModalDialog Polyfill is developed by Jerzy Głowacki under Apache 2.0 License.