專案裡需要彈出子視窗時,JavaScript 有兩條路可走:window.open() 與 window.showModalDialog()。前者開出的是獨立視窗,後者則建立父子關係——子視窗沒關掉之前父視窗無法互動,而且可以傳入參數、取回傳值。以下把用法與踩到的問題一起整理起來。
showModalDialog() (IE 4+ 支援) // 模態對話框 showModelessDialog() (IE 5+ 支援) // 非模態對話框
模態版本會鎖住父視窗,非模態版本則不會,兩者的參數形式完全相同。
vReturnValue = window.showModalDialog(sURL [, vArguments] [, sFeatures]); vReturnValue = window.showModelessDialog(sURL [, vArguments] [, sFeatures]);
sURL(必選,字串):對話框要載入的文件的網址。
vArguments(可選,變體):傳給對話框的參數,型別不限,陣列或物件都可以。對話框內部透過 window.dialogArguments 取得。
sFeatures(可選,字串):描述對話框外觀,多個設定之間以分號分隔。
以下幾個主要用在 HTA 環境,一般網頁用不到:
一、傳入參數靠 vArguments,型別不限制。字串最長 4096 字元,也可以直接傳物件,子視窗用 window.dialogArguments 接收即可。
二、子視窗要回傳資料時,設定 window.returnValue 再關閉自己,父視窗的呼叫端就會拿到這個值,同樣可以是物件。
showModalDialog 是 IE 獨有的私有 API,Chrome、Firefox、Safari 從未實作,Edge 也已經移除。因此它只適合維護老系統,新專案請改用 window.open 搭配 opener,或直接用頁內的 modal 元件(Bootstrap Modal、對話框 polyfill 等),才能兼顧跨平台與可客製性。