内容语言

Content-Language 表示头部 用于描述目标受众的语言,以便用户根据自己的首选语言进行区分。

例如,如果设置了“Content-Language: de-DE”,则表示该文档面向德语使用者(但是,它并不表示文档是用德语编写的。例如,它可能是英语文档,作为德语学习者课程的一部分。如果要指示文档的书写语言,请改用lang 属性)。

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

头部类型 表示头部
禁止的头部名称
CORS 安全列表响应头部
CORS 安全列表请求头部 是,但附加限制是值只能是0-9A-Za-z、空格或*,-.;=

语法

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

指令

语言标签

多个语言标签用逗号分隔。每个语言标签都是一个或多个不区分大小写的子标签的序列,每个子标签用连字符(“-”,%x2D)分隔。在大多数情况下,语言标签包含一个主要语言子标签,用于识别一个广泛的相关语言族(例如,“en”=英语),并可选地后跟一系列子标签,以细化或缩小该语言的范围(例如,“en-CA”=加拿大使用的英语变体)。

注意:语言标签在BCP 47中正式定义,该标准依赖于ISO 639标准(通常是ISO 639-1 代码列表)用于语言代码。

示例

指示文档的书写语言

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

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

不要像这样使用此元元素来声明文档语言

html
<!-- ⚠️ This is bad practice -->
<meta http-equiv="content-language" content="de" />

指示资源的目标受众

Content-Language 头部用于指定页面的目标受众,并且可以指示目标受众不止一种语言。

http
Content-Language: de, en

规范

规范
HTTP 语义
# field.content-language

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅