HTML 中部分字元具有特殊語意(如 < 開始標籤、& 開始實體),若要在網頁顯示這些字元本身,必須使用「實體參考」或「數值字元參考」替代。這稱為 HTML 實體編碼(Entity Encoding),俗稱「轉義」。
| 字元 | 實體名稱 | 十進制 | 十六進制 | 說明 |
|---|---|---|---|---|
< | < | < | < | 小於號,標籤開始 |
> | > | > | > | 大於號,標籤結束 |
& | & | & | & | 連接符,實體開始,**最優先編碼** |
" | " | " | " | 雙引號,屬性值界定 |
' | ' / '* | ' | ' | 單引號,屬性值界定(HTML5 標準實體名為 ') |
* ' 為 XML/HTML5 實體,舊版 IE 不支援,建議用數值參考 '
| 顯示 | 實體名稱 | 數值參考 | 用途 |
|---|---|---|---|
|   | 不換行空白(常用對齊) | |
| © | © | © | 版權符號 |
| ® | ® | ® | 註冊商標 |
| ™ | ™ | ™ | 商標 |
| × | × | × | 乘號/關閉圖示 |
| ÷ | ÷ | ÷ | 除號 |
| ← → ↑ ↓ | ← → ↑ ↓ | ←等 | 方向箭頭 |
| … | … | … | 省略號 |
| 「 」 | “ ” | “ ” | 中文雙引號 |
| 『 』 | „ “ (約定俗成) | „ ” | 中文書名號 |
在「輸出」時編碼,根據「輸出情境」選擇編碼方式。不要在「輸入」或「儲存」時編碼。
| 輸出情境 | 編碼函式/方法 | 範例 |
|---|---|---|
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}"; |
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
早期用 排版間距,**現代開發請改用 CSS**:
.spacing { margin-right: 1rem; } /* 元素間距 */
.indent { text-indent: 2em; } /* 首行縮排 */
.whitespace-pre { white-space: pre-wrap; } /* 保留原始空白換行 */
// 錯誤:重複編碼
$input = '<script>';
$step1 = htmlspecialchars($input); // <script>
$step2 = htmlspecialchars($step1); // &lt;script&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 的核心技能。記住:輸出時編碼、情境決定方式、原始資料不變。