以下是一個以 ASP.NET 實作的最簡 showModalDialog 範例,示範子視窗如何在載入時接收父視窗傳來的參數,以及如何把結果回傳給父視窗。
<%@ Page Language="C#" AutoEventWireup="true"
CodeFile="showdialog_dialog.aspx.cs" Inherits="WSHelpDoc_showdialog_dialog" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="https://www.w3.org/1999/xhtml">
<head runat="server">
<title>showModalDialog 彈出對話框(子視窗)</title>
<script language="javascript" type="text/javascript">
// 頁面載入時讀取父視窗傳來的參數
function loadl() {
document.getElementById("context").value = window.dialogArguments;
}
// 設定回傳值並關閉視窗
function retu_value() {
window.returnValue = "完成了";
window.close();
return false;
}
</script>
</head>
<body onload="loadl()">
<form id="form1" runat="server">
<div>
<asp:Button ID="Button1" runat="server"
OnClientClick="javascript:return retu_value()" Text="關閉" />
</div>
<div>
<a id="biaoqian" onclick="retu_value()">關閉</a>
</div>
<div>
<asp:TextBox ID="context" runat="server"></asp:TextBox>
</div>
</form>
</body>
</html>
loadl() 掛在 body onload 上,負責把 window.dialogArguments 的值寫進 id 為 context 的文字框。因為 showModalDialog 是同步的,父視窗會停在呼叫那一行等待,所以子視窗載入時參數一定已經就位,可以安全讀取。
retu_value() 負責收尾:先把結果寫進 window.returnValue,再呼叫 window.close() 關閉自己。關閉的瞬間父視窗的 showModalDialog 才會返回,並取得剛設定的值。
注意函式最後 return false,這對 <asp:Button> 是必要的——它會阻止控制項的預設回傳行為,避免關掉視窗後又觸發一次 PostBack。
<script type="text/javascript">
function openDialog() {
var result = window.showModalDialog(
'showdialog_dialog.aspx',
'這是傳給子視窗的訊息',
'dialogWidth:400px;dialogHeight:200px;center:yes;'
);
if (result) {
document.getElementById('parentText').value = result;
}
}
</script>
<input type="button" value="開啟對話框" onclick="openDialog()" />
<input type="text" id="parentText" />
三個參數分別是子視窗網址、要傳遞的資料、以及外觀設定。回傳值就是子視窗寫進 returnValue 的內容。
id 寫法不一致:範例中出現 getElementByIdx_x 這種寫法,這是某些技術文件為避免被搜尋引擎誤判而做的變形,實際程式碼中一律應寫成 getElementById。
Runat="server" 控制項的 ClientID 問題:<asp:TextBox ID="context" runat="server"> 產生的 HTML id 未必是 "context",在命名容器中會被改寫。應該用伺服器端語法取得實際 id:
document.getElementById("<%= context.ClientID %>").value = window.dialogArguments;
應加上型別檢查:若父視窗未傳值,window.dialogArguments 會是 undefined,直接賦值給文字框會顯示 "undefined" 字樣。建議:
function loadl() {
var args = window.dialogArguments;
document.getElementById("<%= context.ClientID %>").value = (args == null) ? "" : args;
}
如前所述,showModalDialog 已不再被支援。上面這段範例的現代等價寫法是:
// 父視窗
const dialog = document.querySelector('#myDialog');
dialog.returnValue = '';
dialog.showModal();
dialog.addEventListener('close', function () {
document.getElementById('parentText').value = dialog.returnValue;
});
// 子內容中的關閉按鈕
function closeDialog() {
dialog.returnValue = '完成了';
dialog.close();
}
結構幾乎一一對應:showModal() 對應 showModalDialog、returnValue 同名、關閉時的 close 事件取代同步返回的寫法。差別在於 <dialog> 是標準元件,所有現代瀏覽器都支援,也不必再擔心 ClientID 被改寫的問題。