window.showModalDialog 是 IE 用來彈出「模式視窗」的方法。所謂模式視窗,指的是開啟之後在關閉前無法操作父視窗。
而 returnValue 是 window 物件的屬性,用途是把值從模式視窗回傳給開啟它的父視窗。以下用兩個檔案示範。
// father.html
<HTML>
<HEAD>
<META NAME="GENERATOR" Content="Microsoft Visual Studio 6.0">
<TITLE></TITLE>
<script language="javascript">
function showmodal() {
var ret = window.showModalDialog(
"child.htm", null,
"dialogWidth:350px;dialogHeight:350px;help:no;status:no"
);
if (ret) {
alert('子視窗返回真!');
} else {
alert('子視窗返回假!');
}
}
</script>
</HEAD>
<BODY>
<INPUT id=button1 type=button value=Button name=button1 onclick="showmodal();">
</BODY>
</HTML>
// child.html
<HTML>
<HEAD>
<META NAME="GENERATOR" Content="Microsoft Visual Studio 6.0">
<TITLE></TITLE>
<script language="javascript">
function trans(tag) {
if (tag == 0) {
window.returnValue = false;
} else {
window.returnValue = true;
}
window.close();
}
</script>
</HEAD>
<BODY>
<INPUT id=button1 type=button value="返回真" name=button1 onclick="trans(1)">
<INPUT id=button2 type=button value="返回假" name=button2 onclick="trans(0)">
</BODY>
</HTML>
父視窗用 showModalDialog 開啟子視窗,該呼叫會被「阻斷」,直到子視窗關閉才拿到回傳值;子視窗只要在關閉前設定 window.returnValue,父視窗就能收到。
回傳值不侷限於布林,整數、字串都可以,甚至塞一個 JS 陣列進去,用來傳遞大量資料也沒問題。若要更完整的參數說明,可參考 MSDN 對 showModalDialog 的定義。要注意的是此 API 屬 IE 專屬,後續標準改採 window.showModalDialog 的替代方案(如 <dialog> 元素或 window.open 搭配 postMessage)。