程式原本運行正常,某天同事回報出錯了。追查後發現問題出在傳送的資料中含有 # 之類的特殊字元——瀏覽器只取到 # 前面的部分,後面的全被截斷。以下記錄排查過程與最終解法。
用 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;');"
在 URL 的語法中,# 之後的部分稱為 fragment(片段識別符),它不會被送到伺服器,只存在於瀏覽器端。所以當編號是 AB#123 時:
Info.aspx?bh=AB#123
↑
伺服器只收到 bh=AB,#123 被當成 fragment 丟掉
這與編碼方式無關,而是 URL 結構本身的規則。編號中只要出現 #,就必然被截斷。
直覺的反應是先把資料編碼:
Server.UrlEncode(e.Row.Cells.FromKey("編號").Text.Trim())
結果:可以看到特殊字元確實被編碼了,但正確的資料依然沒有傳過去,錯誤照舊。
為什麼?因為 Server.UrlEncode 是 ASP.NET 的伺服器端方法,編碼結果交給 JavaScript: 這個偽協定處理時,中間又經過了一層解讀。Server.UrlEncode 的設計前提是「這個字串會直接作為 URL 送出」,但這裡它被包在 JavaScript: 敘述裡,編碼規則與解碼時機對不上,於是編碼形同白做。
"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 反而沒問題。這說明問題不在編碼方法本身好不好,而在編碼發生的時機與位置是否正確:
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"](後者會自動解碼)取值。
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 變數傳入,編碼問題自然消失,而且不必再開新視窗。