萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML5 教學

HTML 標籤轉換與實體編碼實戰技巧

HTML 標籤與實體雙向轉換實戰

前後端交互、富文本編輯器、代碼展示等場景,常需在 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, '&amp;')
    .replace(/</g, '&lt;')
    .replace(/>/g, '&gt;')
    .replace(/"/g, '&quot;')
    .replace(/'/g, '&#39;');
}

document.getElementById('codeDisplay').innerHTML = 
  '<pre><code>' + escapeHtml(rawHtml) + '</code></pre>';
</script>

場景二:解碼實體還原 HTML

function decodeHtmlEntities(text) {
  const textarea = document.createElement('textarea');
  textarea.innerHTML = text;
  return textarea.value;
}

// 測試
const encoded = '&lt;div&gt;內容&lt;/div&gt;';
console.log(decodeHtmlEntities(encoded)); // <div>內容</div>

場景三:Struts/JSP 專案中的標籤輸出

<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+

核心原則

  1. 輸入過濾:儲存前清理,但保留原始資料
  2. 輸出編碼:根據輸出語境(HTML/JS/CSS/URL)編碼
  3. 語境感知:<script> 內需 JS 編碼,<style> 內需 CSS 編碼

正確的編碼轉換,是 Web 安全的基石。

copyright © 萬盛學電腦網 all rights reserved