DIV CSS 佈局教程網

showModalDialog 模態視窗:概念、參數與父子視窗互動
編輯:JavaScript綜合知識     

showModalDialog 開出的是一種特別的視窗:當它開啟時,背後的父視窗會完全停止回應,必須先關閉子視窗才能繼續操作。這使它在表單填寫、線上測驗這類需要強制完成的情境中相當好用,而且傳值方式簡潔有力。以下說明用法(此 API 已從標準移除,僅供維護舊系統參考)。

使用方法

vReturnValue = window.showModalDialog(sURL [, vArguments] [, sFeatures])

參數說明

sURL — 必選,字串。對話框要顯示的文件 URL。

vArguments — 可選,變體。向對話框傳遞的參數,型別不限(含陣列)。對話框以 window.dialogArguments 接收。

sFeatures — 可選,字串。描述對話框外觀,多個項目以分號隔開。

sFeatures 可用項目

  • dialogHeight:高度,不小於 100px。IE4 預設單位是 em,IE5 起為 px,建議一律標明 px。
  • dialogWidth:寬度。
  • dialogLeft:離螢幕左側的距離。
  • dialogTop:離螢幕上方的距離。
  • center:{ yes | no | 1 | 0 } 是否置中,預設 yes,仍可指定高寬。
  • help:{ yes | no | 1 | 0 } 是否顯示說明按鈕,預設 yes。
  • resizable:{ yes | no | 1 | 0 } [IE5+] 是否可調整大小,預設 no。
  • status:{ yes | no | 1 | 0 } [IE5+] 是否顯示狀態列,模態預設 no,非模態預設 yes。
  • scroll:{ yes | no | 1 | 0 | on | off } 是否顯示捲動條,預設 yes。

以下幾項只用於 HTA:

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

範例:父視窗傳函式給子視窗呼叫

這個技巧示範了模態視窗最強的一點——可以直接傳遞函式參照,讓子視窗回頭修改父視窗的內容。

parent.html

<script>
function setname(res) {
  document.getElementById("name").value = res;
}

function selectTp() {
  // 把父視窗的 setname 函式傳給子視窗
  window.showModalDialog('child.html', setname,
                         'dialogWidth:300px;dialogHeight:300px;center:yes;');
}
</script>

<input type="button" value="提交" onclick="selectTp()" />
<input type="text" id="name" name="name" />

child.html

<SCRIPT LANGUAGE="JavaScript">
<!--
function setName() {
  var win = "";
  if (window.dialogArguments != null) {
    // 取出父視窗傳來的函式並呼叫,完成賦值
    win = window.dialogArguments;
    win('Jone');
  }
  this.close();
}
//-->
</SCRIPT>

<input type="button" value="給父視窗賦值" onclick="setName()" />

這個範例的巧妙之處

一般跨視窗溝通得靠 opener 或特定的全域變數,而這裡直接把函式當參數傳進去,子視窗取得後呼叫即可,父視窗的值就更新了。這種「把行為當資料傳遞」的思路,在 JavaScript 中到處可見(回呼函式就是同一個概念),套用到跨視窗情境也一樣有效。

要注意的是,這種做法要求父子視窗必須同域,否則同源策略會阻止子視窗存取父視窗的物件。

現代替代方案

showModalDialog 已不再被主流瀏覽器支援。若你需要模態對話框,標準做法是:

// 原生 <dialog> 元素
const dialog = document.querySelector("#myDialog");
dialog.showModal();   // 開啟模態對話框
dialog.close();       // 關閉

// 監聽關閉事件並取回結果
dialog.addEventListener('close', function () {
  console.log(dialog.returnValue);
});

<dialog> 搭配 showModal() 提供真正的模態行為(含 focus 鎖定與背景 inert),並可用 ::backdrop 偽元素自訂遮罩樣式,是取代舊 API 的正確選擇。

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