showModalDialog 開出的是一種特別的視窗:當它開啟時,背後的父視窗會完全停止回應,必須先關閉子視窗才能繼續操作。這使它在表單填寫、線上測驗這類需要強制完成的情境中相當好用,而且傳值方式簡潔有力。以下說明用法(此 API 已從標準移除,僅供維護舊系統參考)。
vReturnValue = window.showModalDialog(sURL [, vArguments] [, sFeatures])
sURL — 必選,字串。對話框要顯示的文件 URL。
vArguments — 可選,變體。向對話框傳遞的參數,型別不限(含陣列)。對話框以 window.dialogArguments 接收。
sFeatures — 可選,字串。描述對話框外觀,多個項目以分號隔開。
以下幾項只用於 HTA:
這個技巧示範了模態視窗最強的一點——可以直接傳遞函式參照,讓子視窗回頭修改父視窗的內容。
<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" />
<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 的正確選擇。