DIV CSS 佈局教程網

showModalDialog 傳參數遇到 # 等特殊字元被截斷的解法
編輯:關於JavaScript     

程式原本運行正常,某天同事回報出錯了。追查後發現問題出在傳送的資料中含有 # 之類的特殊字元——瀏覽器只取到 # 前面的部分,後面的全被截斷。以下記錄排查過程與最終解法。

一、問題現場

用 window.showModalDialog 開啟一個詳情視窗,把資料編號當作 query string 傳過去:

"JavaScript:window.showModalDialog('Info.aspx?bh="
    + Server.UrlEncode(e.Row.Cells.FromKey("編號").Text.Trim())
    + "',null,'dialogWidth:750px;dialogHeight:500px;center:yes;status:no;resizable:yes;');"

二、根本原因:# 是 fragment 的分隔符

在 URL 的語法中,# 之後的部分稱為 fragment(片段識別符),它不會被送到伺服器,只存在於瀏覽器端。所以當編號是 AB#123 時:

Info.aspx?bh=AB#123
                ↑
        伺服器只收到 bh=AB,#123 被當成 fragment 丟掉

這與編碼方式無關,而是 URL 結構本身的規則。編號中只要出現 #,就必然被截斷。

三、第一次嘗試:Server.UrlEncode(失敗)

直覺的反應是先把資料編碼:

Server.UrlEncode(e.Row.Cells.FromKey("編號").Text.Trim())

結果:可以看到特殊字元確實被編碼了,但正確的資料依然沒有傳過去,錯誤照舊。

為什麼?因為 Server.UrlEncode 是 ASP.NET 的伺服器端方法,編碼結果交給 JavaScript: 這個偽協定處理時,中間又經過了一層解讀。Server.UrlEncode 的設計前提是「這個字串會直接作為 URL 送出」,但這裡它被包在 JavaScript: 敘述裡,編碼規則與解碼時機對不上,於是編碼形同白做。

四、第二次嘗試:改用 escape(成功)

"JavaScript:window.showModalDialog('Info.aspx?bh="
    + escape(e.Row.Cells.FromKey("編號").Text.Trim())
    + "',null,'dialogWidth:750px;dialogHeight:500px;center:yes;status:no;resizable:yes;');"

這次參數傳遞正常了。差別在於 escape 是用戶端的函數,在瀏覽器執行這段 JavaScript: 敘述的當下才進行編碼,時機與後續的 URL 解析正好對得上。

五、一個合理的疑惑

值得注意的是:如果不是用模態視窗,而是直接把連結網址打開,Server.UrlEncode 反而沒問題。這說明問題不在編碼方法本身好不好,而在編碼發生的時機與位置是否正確:

  • 直接連結:伺服器輸出 HTML 時就完成編碼,之後瀏覽器直接把它當 URL 導向,時機正確。
  • JavaScript: 偽協定:伺服器編碼的結果被當成 JavaScript 程式碼文字送出,瀏覽器先執行 JS、再由 JS 呼叫 showModalDialog,中間多了一層轉手,編碼就被抵消了。

六、更根本的解法

與其糾結編碼方式,更好的做法是不要把資料放在 URL 上:

// 改用第二個參數傳物件(showModalDialog 支援傳任何物件)
var data = { bh: e.Row.Cells.FromKey("編號").Text.Trim() };
window.showModalDialog("Info.aspx", data,
    "dialogWidth:750px;dialogHeight:500px;center:yes;status:no;resizable:yes;");

在彈出的視窗中用 window.dialogArguments.bh 取值,完全不經過 URL,也就沒有編碼與截斷的問題。

若必須走 URL,請務必使用 encodeURIComponent 而非 escape——escape 已廢棄,不支援 Unicode,且不會編碼 + 等重要字元:

var bh = encodeURIComponent(e.Row.Cells.FromKey("編號").Text.Trim());
window.showModalDialog("Info.aspx?bh=" + bh, null, "...");

伺服器端則用 HttpUtility.UrlDecode 或 Request.QueryString["bh"](後者會自動解碼)取值。

七、最後要說的:showModalDialog 已被移除

window.showModalDialog 在 2014 年就被標記為不建議使用,Chrome 自 2014 年起、Firefox 自 v3 起相繼移除了對它的支援。今天這段程式碼在主流瀏覽器上會直接拋出「不是一個函數」的錯誤。

替代方案:

  • <dialog> 元素:原生支援,自帶焦點管理與 Esc 關閉,可用 showModal() 開啟。
  • 自訂遮罩層:用 position: fixed 的 div 加上焦點陷阱實作。
<dialog id="infoDialog">
    <form method="dialog">
        <p id="infoContent"></p>
        <button>關閉</button>
    </form>
</dialog>

<script>
var dlg = document.getElementById("infoDialog");
document.getElementById("infoContent").textContent = bh;   // textContent 避免 XSS
dlg.showModal();
</script>

改用 <dialog> 之後,參數直接以 JS 變數傳入,編碼問題自然消失,而且不必再開新視窗。

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