Content-Language
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Der HTTP-Content-Language-Repräsentations-Header wird verwendet, um die Sprache(n) zu beschreiben, die für das Publikum bestimmt sind, damit Benutzer sie entsprechend ihrer bevorzugten Sprache unterscheiden können.
Zum Beispiel zeigt Content-Language: de-DE an, dass das Dokument für Deutschsprachige gedacht ist. Das Dokument kann auf Englisch geschrieben sein, nicht auf Deutsch, als Teil eines Sprachkurses für Deutschsprachige. Um die Sprache anzugeben, in der das Dokument geschrieben ist, verwenden Sie stattdessen das lang-Attribut.
Wenn kein Content-Language angegeben ist, ist die Standardeinstellung, dass der Inhalt für alle Sprachgruppen bestimmt ist. Mehrere Sprach-Tags sind ebenfalls möglich, ebenso wie die Anwendung des Content-Language-Headers auf verschiedene Medientypen und nicht nur auf Textdokumente.
| Header-Typ | Repräsentations-Header |
|---|---|
| Verbotener Anforderungs-Header | Nein |
| CORS-sichere Antwort-Header | Ja |
| CORS-sichere Anforderungs-Header | Ja* |
* Werte können nur 0-9, A-Z, a-z, ein Leerzeichen oder die Zeichen *,-.;= sein.
Syntax
Content-Language: de-DE
Content-Language: en-US
Content-Language: de-DE, en-CA
Direktiven
language-tag-
Mehrere Sprach-Tags werden durch ein Komma getrennt. Jedes Sprach-Tag ist eine Abfolge von einem oder mehreren, nicht groß-/kleinschreibungssensitiven Subtags, die jeweils durch ein Bindestrich-Zeichen (
-) getrennt sind. In den meisten Fällen besteht ein Sprach-Tag aus einem primären Sprach-Subtag, der eine breite Familie verwandter Sprachen identifiziert (z. B.en= Englisch) und wird optional von einer Reihe von Subtags gefolgt, die den Geltungsbereich dieser Sprache verfeinern oder eingrenzen (z. B.en-CA= die englische Variante in Kanada).
Hinweis: Sprach-Tags sind formell in BCP 47 definiert, die sich auf den ISO 639-Standard stützen (häufig die ISO 639-1 Code-Liste) für Sprachcodes, die verwendet werden sollen.
Beispiele
Angabe der Sprache, in der ein Dokument geschrieben ist
Das globale lang-Attribut wird auf HTML-Elementen verwendet, um die Sprache eines gesamten HTML-Dokuments oder von Teilen davon anzugeben.
<html lang="de">
…
</html>
Verwenden Sie nicht dieses Meta-Element, um die Dokumentensprache anzugeben, wie unten gezeigt:
<meta http-equiv="content-language" content="de" />
Angabe einer Zielgruppe für eine Ressource
Der Content-Language-Header wird verwendet, um das beabsichtigte Publikum der Seite anzugeben und kann darauf hinweisen, dass dies mehr als eine Sprache ist.
Content-Language: de, en
Spezifikationen
| Specification |
|---|
| HTTP Semantics # field.content-language |