非推奨
This feature has been removed from the Web standards. Though some browsers may still support it, it is in the process of being dropped. Do not use it in old or new projects. Pages or Web apps using it may break at any time.
概要
指定された HTML 文書を含む モーダルダイアログボックスを生成し、表示します。
この機能は過去のものになりました。Web サイトやアプリケーションを修正してください。
Chrome 37 でサポートが廃止されました。ただし、一時的に showModalDialog を再有効化するための Enterprise Policy 設定に追加されました。この showModalDialog() メソッドは、Chrome 43 で完全に削除されました。
Mozilla は、このメソッドのサポートを廃止する予定であると公表しました (バグ 981796)。時期は、Firefox 46 より前ではないだろうとしています。すなわち、2016 年 6 月中旬頃までは使用できる予定です。ESR リリースは、さらに数か月間サポートするでしょう。
構文
returnVal = window.showModalDialog(uri[,arguments][,options]);
returnValは、uriで指定される文書のウィンドウによって設定される returnValue プロパティを示す変数です。uriは、ダイアログボックス中で表示する文書の URI です。argumentsは、ダイアログボックスに渡されるべき値を含むオプションの変数です。これらは、windowオブジェクトのwindow.dialogArgumentsプロパティから取得できるようになります。optionsは、ダイアログボックスに対するウィンドウの装飾を指定するオプションの文字列です。次の表で示す値を、 1 つまたは複数セミコロンで区切って指定します。
| 構文 | 説明 |
|---|---|
center: {on | off | yes | no | 1 | 0 } |
この引数の値が on、yes、または、1 である場合、ダイアログウィンドウはデスクトップの中央に配置されます。それ以外の場合は、ダイアログボックスが隠れます。デフォルトの値は、yes です。 |
dialogheight:height |
ダイアログボックスの高さを指定します。デフォルトでは、ピクセル値でサイズが指定されます。 |
dialogleft:left |
ダイアログボックスの水平位置をデスクトップの左上を基準とした値で指定します。 |
dialogwidth:width |
ダイアログボックスの幅を指定します。デフォルトでは、ピクセル値でサイズが指定されます。 |
dialogtop:top |
ダイアログボックスの垂直位置をデスクトップの左上角を基準とした値で指定します。 |
resizable: {on | off | yes | no | 1 | 0 } |
この引数の値が on、yes、または、1 である場合、ダイアログウィンドウは、ユーザによってリサイズ可能になります。それ以外の場合は、ウィンドウのサイズが自動で調整されます。デフォルトの値は、no です。 |
scroll: {on | off | yes | no | 1 | 0 } |
この引数の値が on、yes、または、1 である場合、ダイアログボックスにスクロールバーが表示されます。それ以外の場合は、ボックスのサイズが自動で調整されます。デフォルトの値は、no です。 |
dialogHide、edge、status、および、unadorned 引数を実装していません。互換性
Microsoft Internet Explorer 4 で実装され、Firefox では、Firefox 3 で (Fx 28 で非推奨)、Safari は Safari 5.1 でサポートが追加されました。Safari から削除される可能性については、WebKit bug 151885 をご覧ください。
例
注記
showModalDialog() is currently being standardized as part of HTML5. The third argument (for additional options) is not present in the HTML5 version, and is (safely) ignored by both Safari and Chrome.
仕様
- Microsoft MSDN: showModalDialog
関連情報
window.showModalDialog()を置き換える<dialog><dialog>および generators を使用した、showModalDialog Polyfill