Content-Language header

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-Darstellungs-Header wird verwendet, um die Sprache(n) zu beschreiben, die für das Publikum vorgesehen sind, sodass Benutzer sie entsprechend ihrer eigenen bevorzugten Sprache unterscheiden können.

Zum Beispiel gibt Content-Language: de-DE an, dass das Dokument für deutschsprachige Nutzer bestimmt ist. Das Dokument kann auf Englisch und nicht auf Deutsch verfasst sein, 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 der Standard, dass der Inhalt für alle Sprachpublika bestimmt ist. Mehrere Sprach-Tags sind ebenfalls möglich, ebenso wie die Anwendung des Content-Language-Headers auf verschiedene Medientypen und nicht nur auf schriftliche Dokumente.

Header-Typ Darstellungs-Header
Verbotener Anforderungs-Header Nein
CORS-gesicherter Antwort-Header Ja
CORS-gesicherter Anforderungs-Header Ja*

* Werte können nur 0-9, A-Z, a-z, ein Leerzeichen oder die Zeichen *,-.;= sein.

Syntax

http
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 Folge von einem oder mehreren Groß-/Kleinschreibungskontext-unabhängigen Untertags, die jeweils durch einen Bindestrich (-) getrennt sind. In den meisten Fällen besteht ein Sprach-Tag aus einem primären Sprach-Untertag, der eine breite Familie verwandter Sprachen identifiziert (z.B. en = Englisch), und wird optional von einer Reihe von Untertags gefolgt, die den Bereich dieser Sprache präzisieren oder einschränken (z.B. en-CA = die Variante des Englischen, wie sie in Kanada verwendet wird).

Hinweis: Sprach-Tags sind formal in BCP 47 definiert, die sich auf den ISO 639-Standard stützen (häufig die ISO-639-1-Codeliste) für Sprach-Codes zur Verwendung.

Beispiele

Angabe der Sprache, in der ein Dokument verfasst ist

Das globale lang-Attribut wird auf HTML-Elementen verwendet, um die Sprache eines gesamten HTML-Dokuments oder Teile davon anzugeben.

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

Verwenden Sie nicht dieses Meta-Element, um die Sprache des Dokuments anzugeben, wie unten gezeigt:

html
<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 es sich um mehr als eine Sprache handelt.

http
Content-Language: de, en

Spezifikationen

Specification
HTTP Semantics
# field.content-language

Browser-Kompatibilität

Siehe auch