後端把一段 HTML 拼成字串丟到前端,前端再用 JavaScript 塞進某個元素——這是老式專案常見的做法,也是引號地獄的溫床。
假設後端(JSP)有個變數 lefttree,內容是這樣一段 HTML:
<div class="test" onclick="show('tt1','abc')">
前端想用 JS 把它寫進某個容器:
<script type="text/javascript">
window.parent.document.getElementById('mptree').innerHTML='<%=lefttree%>';
</script>
輸出之後就炸掉了。因為 lefttree 裡同時有雙引號(class="test")和單引號('tt1'),而最外層用的是單引號,於是字串在 onclick= 之後就被提前結束:
'<div class="test" onclick="show('tt1','abc')">'
↑ 這裡字串就斷了
在後端拼接時,把單引號前面加上斜線:
<div class="test" onclick="show(///'tt1///',///'abc///')">
三個斜線各有分工:前兩個 // 是為了在頁面輸出後仍能保留一個 /,第三個 / 則用來轉義後面的單引號。經過 JSP 與瀏覽器兩層處理,最終 DOM 中剩下:
<div class="test" onclick="show(/'tt1/',/'abc/')">
能動,但很醜,而且 /'tt1'/ 這種值顯然不是原本想傳的字串。這個解法只能說是「讓它不要報錯」。
引號衝突的根本原因是資料與程式碼混在同一層。把資料用 JSON 傳,就不會有引號問題:
<script type="text/javascript">
var lefttree = JSON.parse('<%=jsonEncodedString%>');
document.getElementById('mptree').innerHTML = lefttree;
</script>
後端用 JSON 序列化函式庫編碼,引號、換行、反斜線都會被正確處理。
內奶奶的 onclick 屬性是麻煩的源頭。改用事件代理,HTML 裡只需要 data 屬性:
<div class="test" data-id="tt1" data-value="abc">
document.getElementById('mptree').addEventListener('click', function (e) {
var target = e.target.closest('.test');
if (!target) return;
show(target.dataset.id, target.dataset.value);
});
這樣一來,HTML 裡完全沒有 JavaScript,引號只有 HTML 自己那一層,衝突自然消失。而且內奶奶的 onclick 還有幾個附帶問題:無法用 removeEventListener 解除、在嚴格的 Content Security Policy 下會被瀏覽器直接攔掉、以及每個元素都要各自綁一次。
請注意,把外部內容寫進 innerHTML 是 XSS 的主要途徑。若 lefttree 含任何使用者輸入,必須先經過 sanitize(例如 DOMPurify),否則對方能直接注入 script 或事件屬性。純文字情境下,改用 textContent 就安全了:
document.getElementById('mptree').textContent = plainTextValue;