用 MagicAjax 這個框架的人不少,但很多人沒注意到它對 HTML 特殊字元沒有做完整處理,結果非同步回呼之後,頁面上的符號會顯示錯亂。本文說明問題成因與兩種解法。
像是 ?;(? 代表 ISO 8859-1 的編碼)、<、>、&、" 這類符號,在回呼之後可能無法正確顯示。舉例來說,若文字方塊的值是「所有<100公斤的豬」,其中含有一個小於號,而 & 又被額外轉義,最後方塊裡可能變成 &lt 這種一團字元。
在輸出資料前,把半形符號逐一換成全形。
string str = "所有<100公斤的豬";
str = str.Replace("<", "<"); // 還要處理 >、&、" 等符號
這個方法寫起來笨、也容易漏,只適合臨時應付。
從官網下載 .NET 2.0 版本的原始碼,打開專案,找到 AjaxCallHelper.cs,其中有一個 EncodeString 方法負責把字串轉成可安全傳輸的形式:
public static string EncodeString(string str)
{
System.Text.StringBuilder sb = new System.Text.StringBuilder(str);
sb.Replace("\\", "\\\\");
sb.Replace("\"", "\\\"");
sb.Replace("\r", "\\r");
sb.Replace("\n", "\\n");
sb.Replace("\t", "\\t");
sb.Replace("<", "<");
sb.Replace("&", "&");
sb.Insert(0, '"');
sb.Append('"');
return sb.ToString();
}
在這段邏輯裡補上特殊字元的轉義處理,重新建置(Release)專案並改用新的組件,問題就解決了。這種做法一劳永逸,不必在每個頁面各自補救。
讓 MagicAjax 支援中文的討論網上已經很多,這裡不贅述,不過在项目裡確實好用。另外有個實務技巧:當某個按鈕位於 AjaxPanel 內時,直接註冊 JavaScript 的 alert 腳本不會跳出提示框,改用框架提供的寫法即可正常彈出。
AjaxCallHelper.WriteAlert("資料儲存成功!");
理解這個框架的更新機制之後,就能明白為什麼一般的 alert 註冊會失效——回呼處理的執行時機與頁面重新組裝的順序不同,腳本得透過框架的訊息通道送出才會被執行。