Content-Language ヘッダー
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
Content-Language は 表現ヘッダーで、ユーザーが自分の好みの言語に応じて区別できるように、オーディエンス向けの言語を記述するために使用されます。
たとえば、Content-Language: de-DE が設定されている場合、その文書はドイツ語の話者を対象としています（ただし、文書がドイツ語で記述されていることを示すわけではありません。 たとえば、ドイツ語話者のための語学コースの一部として英語が書かれているかもしれません。文書が記述されている言語を示す場合は、代わりに lang 属性を使用します）。
Content-Language が指定されていない場合、デフォルトではコンテンツはすべての言語のオーディエンスを対象としています。Content-Language ヘッダーをテキスト形式の文書やさまざまな種類のメディアに適用するだけでなく、複数の言語タグを使用することもできます。
| ヘッダー種別 | 表現ヘッダー |
|---|---|
| 禁止リクエストヘッダー | いいえ |
| CORS セーフリストレスポンスヘッダー | はい |
| CORS セーフリストリクエストヘッダー | はい* |
* 値は 0-9、A-Z、a-z、空白、*,-.;= のいずれかの文字のみを取ることができます。
構文
Content-Language: de-DE
Content-Language: en-US
Content-Language: de-DE, en-CA
ディレクティブ
language-tag-
複数の言語タグはカンマで区切られています。各言語タグはハイフン文字 (
-,%x2D) で区切られた、大文字小文字を区別しない 1 つ以上のサブタグのシーケンスです。ほとんどの場合、言語タグは関連する言語の広いファミリを識別するプライマリ言語サブタグ (たとえば、en= 英語) で構成され、オプションとして、その言語の範囲を絞り込むか狭める一連のサブタグ (en-CA= カナダで伝達される英語の種類) が続きます。
メモ: 言語は BCP 47 言語タグを使用して指定されます。これらは使用する言語コードについて、ISO 639 規格 (ISO 639-1 のコードリストであることが多い) に依存しています。
例
文書が書かれている言語を示す
グローバルの lang 属性は、HTML 文書全体またはその一部の言語を示すために HTML 要素で使用されます。
<html lang="de">
…
</html>
文書の言語を記述するために、このような meta 要素を以下のように使用しないでください。
<meta http-equiv="content-language" content="de" />
リソースのターゲットオーディエンスを示す
Content-Language ヘッダーは、ページの対象読者を指定するために使用され、複数の言語であることを示すことができます。
Content-Language: de, en
仕様書
| 仕様書 |
|---|
| HTTP Semantics # field.content-language |