前後端交互、富文本編輯器、代碼展示等場景,常需在 HTML 標籤與實體編碼之間轉換。掌握雙向轉換技巧能避免顯示異常與安全漏洞。
<div id="codeDisplay"></div>
<script>
// 後端返回的原始 HTML 字串
const rawHtml = '<div class="box">內容</div>';
// 方法 1:瀏覽器原生轉義
function escapeHtml(text) {
const div = document.createElement('div');
div.textContent = text;
return div.innerHTML;
}
// 方法 2:手動替換(Node.js/無 DOM 環境)
function escapeHtmlManual(text) {
return text
.replace(/&/g, '&')
.replace(/</g, '<')
.replace(/>/g, '>')
.replace(/"/g, '"')
.replace(/'/g, ''');
}
document.getElementById('codeDisplay').innerHTML =
'<pre><code>' + escapeHtml(rawHtml) + '</code></pre>';
</script>
function decodeHtmlEntities(text) {
const textarea = document.createElement('textarea');
textarea.innerHTML = text;
return textarea.value;
}
// 測試
const encoded = '<div>內容</div>';
console.log(decodeHtmlEntities(encoded)); // <div>內容</div>
<body>
<div id="mydiv"></div>
<script type="text/javascript">
// Struts 標籤輸出訊息,需正確轉義
document.getElementById("mydiv").innerHTML =
"<s:property value='message.message' escape='true'/>";
</script>
<s:debug/>
</body>
關鍵屬性 escape="true" 確保輸出內容自動實體編碼,防止 XSS。
<!-- Prism.js 範例 -->
<pre><code class="language-html"><script>
// 你的代碼這裡已預先轉義
</script></code></pre>
// 若動態載入代碼
fetch('/api/code-snippet')
.then(r => r.text())
.then(code => {
document.querySelector('code').textContent = code;
Prism.highlightAll();
});
| 環境 | 推薦庫/方法 | 特點 |
|---|---|---|
| 瀏覽器 | DOMPurify + textContent | 安全、標準、無依賴 |
| Node.js | he (HTML Entities) | 完整實體支援、雙向轉換 |
| PHP | htmlspecialchars / html_entity_decode | 內建、效能佳 |
| Python | html.escape / html.unescape | 標準庫、Python 3.4+ |
<script> 內需 JS 編碼,<style> 內需 CSS 編碼正確的編碼轉換,是 Web 安全的基石。