1. 面向开发者的 Web 技术
  2. HTML（超文本标记语言）
  3. HTML 参考
  4. 全局属性
  5. lang

此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

lang

基线 广泛可用

自 2015年7月 起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

lang 全局属性 参与了元素语言的定义。这个语言是不可编辑元素写入的语言，或者可编辑元素应该写入的语言。标签包含单个条目，值的格式由 用于定义语言的标签 (BCP47) IETF 文档定义。如果标签的内容是空字符串，语言就设为未知。如果标签内容是无效的，根据 BCP47，它就设为无效。

尝试一下

<p>This paragraph is English, but the language is not specifically defined.</p>

<p lang="en-GB">This paragraph is defined as British English.</p>

<p lang="fr">Ce paragraphe est défini en français.</p>

p::before {
  padding-right: 5px;
}

[lang="en-GB"]::before {
  content: "(In British English) ";
}

[lang="fr"]::before {
  content: "(In French) ";
}

备注：语言标签语法完整的 BCP47 语法足以标记极其特定的语言方言，但大多数用法都要简单得多。语言标记由连字符分隔的语言子标签组成，其中每个子标签指示该语言的特定属性。3 个最常见的子标签是：

语言子标签

Required。一个 2 或 3 个字符的代码，用于定义基本语言，通常全部用小写编写。例如，English 的语言代码是en，Badeshi 的代码是bdz。

脚本子标签

该子标签定义了用于该语言的书写系统，并且总是 4 个字符长，首字母大写。例如，French-in-Braille 是fr-Brai，ja-Kana是用 Katakana 字母书写的日文。如果语言是以非常典型的方式编写的，例如拉丁字母表中的英语，则无需使用此子标签。

地区子标签

该子标签定义了来自特定位置的基本语言的方言，并且是 ALLCAPS 中与国家代码匹配的 2 个字母，或者是与非国家区域匹配的 3 个数字。例如，es-ES是西班牙语中的西班牙语，es-013是中美洲的西班牙语。 “国际西班牙语”就是es。如果两者都存在，则脚本子标签位于区域子标签之前 ––ru-Cyrl-BY 是俄语，用白俄罗斯语中的西里尔字母书写。要查找语言的正确子标签代码，请参阅语言子标签查找。

即使设置了 lang 属性，也可能无效，因为 xml:lang 属性更加优先。

对于 CSS 伪类:lang，如果它们的名称不同，则两个无效的语言名称是不同的。比如:lang(es)匹配lang = "es-ES"和lang = "es-419"，而:lang(xyzzy)与lang = "xyzzy-Zorp!"不匹配。

规范

规范
HTML
# attr-lang

浏览器兼容性

相关链接

帮助改进 MDN

了解如何参与贡献

此页面最后更新于 ，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题