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

瀏覽器相容性

另見