DIV CSS 佈局教程網

showModalDialog 子視窗實作:接收參數與回傳結果
編輯:JavaScript綜合知識     

以下是一個以 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 被改寫的問題。

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