lang 屬性用於聲明元素內容的**自然語言**,是 HTML 文檔的重要元數據,影響:
<!DOCTYPE html>
<html lang="zh-CN"> <!-- 簡體中文 -->
<head>...</head>
<body>...</body>
</html>
<p>這是中文內容。</p>
<p lang="en">This is English content.</p>
<blockquote lang="ja">これは日本語です。</blockquote>
<code lang="python">print("Hello")</code>
<html xmlns="https://www.w3.org/1999/xhtml" lang="zh-CN" xml:lang="zh-CN">
格式:`language[-script][-region][-variant][-extension]`
| 代碼 | 語言 | 說明 |
|---|---|---|
| zh-CN | 中文(中國大陸簡體) | 最常用 |
| zh-TW | 中文(台灣繁體) | 繁體中文 |
| zh-HK | 中文(香港繁體) | 港式繁體 |
| zh-SG | 中文(新加坡簡體) | 新加坡簡體 |
| en | 英語(通用) | 不指定地區 |
| en-US | 英語(美國) | 美式拼寫/日期/貨幣 |
| en-GB | 英語(英國) | 英式拼寫/日期/貨幣 |
| ja | 日語 | |
| ko | 韓語 | |
| fr | 法語 | |
| de | 德語 | |
| es | 西班牙語 | |
| ar | 阿拉伯語 | RTL 書寫方向 |
完整列表見 IANA Language Subtag Registry。
/* 中文自動使用全形標點 */
:lang(zh) {
font-family: "PingFang SC", "Microsoft YaHei", "Noto Sans SC", sans-serif;
punctuation-trim: adjacent; /* CSS Text 4 草案 */
}
/* 日文縱排 */
:lang(ja) {
writing-mode: vertical-rl;
text-orientation: mixed;
}
/* 阿拉伯語 RTL 佈局微調 */
:lang(ar) { direction: rtl; }
| 錯誤 | 後果 | 修正 |
|---|---|---|
| 缺少 lang 屬性 | 螢幕閱讀器用默認語言讀中文 → 亂碼發音 | 補上 `` |
| 寫成 `lang="zh"` | 無法區分簡繁,翻譯/拼寫檢查可能錯誤 | 具體到區域:`zh-CN`/`zh-TW`/`zh-HK` |
| 動態切換語言未更新 lang | 螢幕閱讀器仍按舊語言朗讀新內容 | JS 同步更新 `document.documentElement.lang` |
| 代碼片段未標註 lang | 螢幕閱讀器嘗試按自然語言讀代碼 | `` 或 `lang="zxx"` (無語言內容) |
<!-- html-validate 規則 -->
{ "rules": { "lang-attribute": "error" } }
<!-- axe-core 無障礙掃描 -->
await axe.run(document, { rules: { 'html-has-lang': { enabled: true } } });