DIV CSS 佈局教程網

innerText 與 innerHTML:引號被轉義該怎麼辦
編輯:關於JavaScript     

從後端拿到一段 JSON 字串,準備顯示在頁面上,結果畫面上出現的是原始碼或一堆 " 之類的字符——這個問題幾乎每個人都遇過。原因通常只有一個:取值與寫入的方法選錯了。

狀況一:EL 表達式把 HTML 轉義了

在 JSP 中直接輸出含 HTML 的變數時,字元會被轉義成實體,瀏覽器於是把它當文字顯示。解法是關閉 XML 轉義:

<c:out value='${jxOrgJsonStr}' escapeXml="false"/>

escapeXml="false" 告訴 JSTL 不要進行跳脫。但要非常小心:這等於關掉了 XSS 的防線。只有在內容來源可信(例如你自己維護的設定檔)時才能這樣做;若字串中含有使用者輸入,必須先做白名單消毒再輸出。

狀況二:innerText 把標籤當成純文字

另一個常見寫法是改用 innerText 接收值:

document.getElementById('xxxx').innerText = xxxx;

innerText 的語意是「純文字」,因此即使字串裡有 <b>、<style>,也會被原封不動地顯示出來。曾有人在做 FCKeditor 資料展示時遇到「HTML 與 CSS 全部攤在畫面上」,就是這個原因。

正確做法:改用 innerHTML

document.getElementById('xxxx').innerHTML = xxxx;

innerHTML 會把字串解析為 HTML,標籤才會真正生效。上面的引號問題也是同一個道理:寫入端選對方法,轉義與否的問題就自然消失。

兩個方法的差異整理

var el = document.getElementById('demo');

el.innerText = "<b>粗體</b>";   // 畫面顯示:<b>粗體</b>
el.innerHTML = "<b>粗體</b>";   // 畫面顯示:粗體(真的變粗)

// 讀取時同理
el.innerText;   // 只拿到可見文字
el.innerHTML;   // 拿到含標籤的原始 HTML

選擇原則:要顯示純文字(尤其是使用者輸入)用 textContent;要渲染 HTML 才用 innerHTML。順帶一提,讀取純文字時 textContent 比 innerText 更合適——後者會觸發 reflow 以取得「渲染後」的文字,效能較差,且不包含隱藏元素。

如果確實要顯示 HTML 又要安全

先消毒再寫入。可以用 DOMParser 解析後移除危險元素與屬性,或直接採用成熟套件:

// 概念示意:只允許特定標籤
const allowed = ['B', 'I', 'EM', 'STRONG', 'P', 'BR'];
const doc = new DOMParser().parseFromString(html, 'text/html');
doc.querySelectorAll('*').forEach(node => {
  if (!allowed.includes(node.tagName)) node.remove();
});
el.innerHTML = doc.body.innerHTML;

實務上更推薦 DOMPurify 這類專門的消毒庫,涵蓋的攻擊手法比手工白名單完整得多。

小結

遇到「引號變成 &#034;」或「標籤被顯示出來」,先確認是不是在寫入端用了 innerText 或在輸出端開了 escapeXml="false"。對症下藥比事後的字串取代可靠,而關閉轉義前,務必先想清楚資料來源是否可信。

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