萬盛學電腦網

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

HTML lang 屬性完整指南:語言聲明、SEO 與無障礙關鍵作用

lang 屬性定義與作用

lang 屬性用於聲明元素內容的**自然語言**,是 HTML 文檔的重要元數據,影響:

  • 🔍 **搜索引擎 SEO**:幫助爬蟲識別頁面語言,提升相關語言搜索排名
  • 🗣️ **螢幕閱讀器**:正確選擇發音引擎、語速、斷詞規則(關鍵無障礙需求)
  • 🔤 **瀏覽器功能**:自動翻譯提示、拼寫檢查、斷詞換行、引號樣式
  • 🎨 **CSS 偽類**:`:lang(zh)` 針對特定語言樣式(如中文標點、日文縱排)
  • 📱 **用戶代理**:語音助手、閱讀模式、內容提取工具

正確使用姿勢

1. 文檔級聲明(必須,放在 `` 標籤)

<!DOCTYPE html>
<html lang="zh-CN"> <!-- 簡體中文 -->
<head>...</head>
<body>...</body>
</html>

2. 局部語言切換(元素級)

<p>這是中文內容。</p>
<p lang="en">This is English content.</p>
<blockquote lang="ja">これは日本語です。</blockquote>
<code lang="python">print("Hello")</code>

3. XHTML 兼容寫法(舊項目)

<html xmlns="https://www.w3.org/1999/xhtml" lang="zh-CN" xml:lang="zh-CN">

語言代碼標準:BCP 47

格式:`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。

CSS :lang() 偽類實戰

/* 中文自動使用全形標點 */
: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`)
  • ✅ 多語言頁面:主語言在 ``,局部切換在具體元素
  • ✅ 動態語言切換:JS 修改 `document.documentElement.lang` 並更新 `document.title`
  • ✅ 測試:NVDA/VoiceOver/TalkBack 實機體驗朗讀效果

常見錯誤

錯誤後果修正
缺少 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 } } });
copyright © 萬盛學電腦網 all rights reserved