DIV CSS 佈局教程網

window.showModalDialog() 參數與用法完整解析
編輯:關於JavaScript     

專案裡需要彈出子視窗時,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(可選,字串):描述對話框外觀,多個設定之間以分號分隔。

  1. dialogHeight:對話框高度,不小於 100px。IE4 中預設單位是 em,IE5 之後是 px,為了避免混淆建議一律明確寫上 px。
  2. dialogWidth:對話框寬度。
  3. dialogLeft:距離螢幕左側的距離。
  4. dialogTop:距離螢幕頂端的距離。
  5. center:{ yes | no | 1 | 0 } 視窗是否置中,預設 yes,但仍可同時指定高與寬。
  6. help:{ yes | no | 1 | 0 } 是否顯示說明按鈕,預設 yes。
  7. resizable:{ yes | no | 1 | 0 }(IE5+)是否允許調整大小,預設 no。
  8. status:{ yes | no | 1 | 0 }(IE5+)是否顯示狀態列,模態預設 no、非模態預設 yes。
  9. scroll:{ yes | no | 1 | 0 | on | off } 是否顯示捲軸,預設 yes。

以下幾個主要用在 HTA 環境,一般網頁用不到:

  1. dialogHide:{ yes | no | 1 | 0 | on | off } 列印或預覽時是否隱藏對話框,預設 no。
  2. edge:{ sunken | raised } 邊框樣式,預設 raised。
  3. unadorned:{ yes | no | 1 | 0 | on | off },預設 no。

參數傳遞的兩個要點

一、傳入參數靠 vArguments,型別不限制。字串最長 4096 字元,也可以直接傳物件,子視窗用 window.dialogArguments 接收即可。

二、子視窗要回傳資料時,設定 window.returnValue 再關閉自己,父視窗的呼叫端就會拿到這個值,同樣可以是物件。

一定要知道的限制

showModalDialog 是 IE 獨有的私有 API,Chrome、Firefox、Safari 從未實作,Edge 也已經移除。因此它只適合維護老系統,新專案請改用 window.open 搭配 opener,或直接用頁內的 modal 元件(Bootstrap Modal、對話框 polyfill 等),才能兼顧跨平台與可客製性。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved