在 JS 開發中,你大概遇過這樣的窘境:需要用 JS 動態插入 HTML 標籤,特別是變數多、引號層層嵌套時,轉義字元到處飛,一個符號寫錯就整段爆掉。
先看一段傳統寫法:
<!DOCTYPE html> <html xmlns="https://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title></title> <script> window.onload = function () { var id = '1'; var code = 'zhangsan'; var name = '張三'; document.getElementById('test').innerHTML = '<a href="#" onclick="buttonClick(\"' + id + '\",\"' + code + '\">' + name + '</a>'; } function buttonClick(id, code) { alert(id + '-' + code); } </script> </head> <body> <div id="test"></div> </body> </html>
直接執行就會報錯。

把 \" 換成 \' 再試一次,畫面依然不如預期。
問題不只是「跑不動」,而是這種程式碼看起來雜亂、難以維護,改一個引號就可能連帶弄壞其他地方。
String.js
(function () { /// <summary> /// 引號轉義符號 /// </summary> String.EscapeChar = '\''; /// <summary> /// 替換所有符合的內容 /// </summary> /// <param name="searchValue">檢索值</param> /// <param name="replaceValue">替換值</param> String.prototype.replaceAll = function (searchValue, replaceValue) { var regExp = new RegExp(searchValue, "g"); return this.replace(regExp, replaceValue); } /// <summary> /// 格式化字串:用 {0}、{1} 佔位,並把 % 還原成引號 /// </summary> String.prototype.format = function () { var regexp = /\{(\d+)\}/g; var args = arguments; var result = this.replace(regexp, function (m, i, o, n) { return args[i]; }); return result.replaceAll('%', String.EscapeChar); } })();
改用佔位符之後,用 % 代替引號轉義符,程式碼乾淨許多,維護與除錯都輕麵不少:
<!DOCTYPE html> <html xmlns="https://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title></title> <script src="String.js"></script> <script> window.onload = function () { var id = '1'; var code = 'zhangsan'; var name = '張三'; document.getElementById('test').innerHTML = '<a href="#" onclick="buttonClick(%{0}%,%{1}%)">{2}</a>'.format(id, code, name); } function buttonClick(id, code) { alert(id + '-' + code); } </script> </head> <body> <div id="test"></div> </body> </html>
測試結果正確,點擊事件也確實收到了參數值。

案例下載:https://wd.jb51.net:81//201612/yuanma/StringFormat_jb51.rar
補充一點:ES6 之後有原生樣板字面值(template literal),用反引號包字串、${} 內插值,就能直接解決大半的拼接問題。不過若你需要把「引號」也一併處理掉(例如產生行內 onclick),本文這種 % 佔位符的做法仍然很好用。另外要留意 replaceAll 裡的 searchValue 若是特殊字元,可能需要自行 escape,才能避免被當成正則語法。