Content-Language 标头

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

HTTP Content-Language 表示标头用于描述受众的预期语言,以便用户可以根据自己偏好的语言进行区分。

例如,Content-Language: de-DE 表示该文档面向德语使用者。该文档可能以英文而非德文撰写,作为德语使用者语言课程的一部分。要指示文档所使用的语言,请改用 lang 属性。

如果未指定 Content-Language,则默认情况下内容面向所有语言受众。也可以使用多个语言标签,并且 Content-Language 标头可以应用于各种媒体类型,而不仅仅是文本文档。

头类型 表示形式头
禁止请求头
CORS-safelisted 响应头
CORS 安全列表请求头 是*

* 值只能是 0-9A-Za-z、空格或字符 *,-.;=

语法

http
Content-Language: de-DE
Content-Language: en-US
Content-Language: de-DE, en-CA

指令

语言标签

多个语言标签用逗号分隔。每个语言标签都是一个或多个不区分大小写的子标签的序列,每个子标签用连字符 (-) 分隔。在大多数情况下,语言标签由一个主要语言子标签组成,该子标签标识一个广泛的相关语言家族(例如,en = 英语),并且可选地后跟一系列子标签,这些子标签细化或缩小该语言的范围(例如,en-CA = 加拿大通用的英语变体)。

注意:语言是使用 BCP 47 语言标签指定的,该标签依赖于 ISO 639 标准(通常是 ISO 639-1 代码列表)用于要使用的 语言代码

示例

指示文档所使用的语言

全局 lang 属性用于 HTML 元素,以指示整个 HTML 文档或其部分内容的语言。

html
<html lang="de">
  …
</html>

不要使用以下 meta 元素来声明文档语言,如下所示

html
<meta http-equiv="content-language" content="de" />

指示资源的受众

Content-Language 标头用于指定页面的预期受众,并且可以指示这不仅仅是一种语言。

http
Content-Language: de, en

规范

规范
HTTP 语义
# field.content-language

浏览器兼容性

另见