萬盛學電腦網

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

HTML 實體編碼(轉義)完整指南:特殊字元對照表、編碼時機與安全應用

什麼是 HTML 實體編碼?

HTML 中部分字元具有特殊語意(如 < 開始標籤、& 開始實體),若要在網頁顯示這些字元本身,必須使用「實體參考」或「數值字元參考」替代。這稱為 HTML 實體編碼(Entity Encoding),俗稱「轉義」。

五大必須編碼的保留字元

字元實體名稱十進制十六進制說明
<&lt;&#60;&#x3C;小於號,標籤開始
>&gt;&#62;&#x3E;大於號,標籤結束
&&amp;&#38;&#x26;連接符,實體開始,**最優先編碼**
"&quot;&#34;&#x22;雙引號,屬性值界定
'&#39; / &apos;*&#39;&#x27;單引號,屬性值界定(HTML5 標準實體名為 &apos;)

* &apos; 為 XML/HTML5 實體,舊版 IE 不支援,建議用數值參考 &#39;

常用符號實體速查

顯示實體名稱數值參考用途
 &nbsp;&#160;不換行空白(常用對齊)
©&copy;&#169;版權符號
®&reg;&#174;註冊商標
™&trade;&#8482;商標
×&times;&#215;乘號/關閉圖示
÷&divide;&#247;除號
← → ↑ ↓&larr; &rarr; &uarr; &darr;&#8592;等方向箭頭
…&hellip;&#8230;省略號
「 」&ldquo; &rdquo;&#8220; &#8221;中文雙引號
『 』&bdquo; &ldquo; (約定俗成)&#8222; &#8221;中文書名號

編碼時機:黃金法則

在「輸出」時編碼,根據「輸出情境」選擇編碼方式。不要在「輸入」或「儲存」時編碼。

情境化編碼對照

輸出情境編碼函式/方法範例
HTML 內容區塊(<div>、<p> 等)htmlspecialchars($str, ENT_QUOTES, 'UTF-8') (PHP)
escapeHtml(str) (JS)
<div>{encoded}</div>
HTML 屬性值(雙引號)同左<input value="{encoded}">
HTML 屬性值(單引號)同左(需含單引號編碼)<input value='{encoded}'>
JavaScript 字串字面值json_encode($str) (PHP)
JSON.stringify(str) (JS)
const msg = {encoded};
URL 查詢參數urlencode() / rawurlencode()?q={encoded}
CSS 值cssesc() (需函式庫)content: "{encoded}";

JavaScript 實作 escapeHtml

function escapeHtml(text) {
  const map = {
    '&': '&',
    '<': '<',
    '>': '>',
    '"': '"',
    "'": '''
  };
  return text.replace(/[&<>"']/g, m => map[m]);
}

// 使用範例
const userInput = '<script>alert(1)</script>';
element.textContent = userInput; // ✅ 最安全:直接用 textContent
element.innerHTML = escapeHtml(userInput); // ✅ 次佳:手動編碼後 innerHTML

空白處理:&nbsp; 與 CSS 替代方案

早期用 &nbsp;&nbsp;&nbsp; 排版間距,**現代開發請改用 CSS**:

.spacing { margin-right: 1rem; }       /* 元素間距 */
.indent { text-indent: 2em; }           /* 首行縮排 */
.whitespace-pre { white-space: pre-wrap; } /* 保留原始空白換行 */

雙重編碼問題與偵測

// 錯誤:重複編碼
$input = '<script>';
$step1 = htmlspecialchars($input); // &lt;script&gt;
$step2 = htmlspecialchars($step1); // &amp;lt;script&amp;gt; ❌

// 正確:只編碼一次,或使用雙重編碼偵測
function safeHtmlspecialchars($str, $flags = ENT_QUOTES, $encoding = 'UTF-8') {
  // 簡易偵測:若已包含實體則跳過(生產環境建議用成熟函式庫)
  if (preg_match('/&#[0-9]+;|&[a-z]+;/i', $str)) return $str;
  return htmlspecialchars($str, $flags, $encoding);
}

掌握 HTML 實體編碼,不僅能正確顯示特殊符號,更是防禦 XSS 的核心技能。記住:輸出時編碼、情境決定方式、原始資料不變。

copyright © 萬盛學電腦網 all rights reserved