Content-Language

Der HTTP Content-Language Repräsentations-Header wird verwendet, um die für die Zielgruppe vorgesehenen Sprache(n) zu beschreiben, sodass Benutzer sie entsprechend ihrer eigenen bevorzugten Sprache unterscheiden können.

Zum Beispiel zeigt Content-Language: de-DE an, dass das Dokument für deutschsprachige Nutzer gedacht ist. Das Dokument kann in Englisch verfasst sein, nicht auf Deutsch, als Teil eines Sprachkurses für deutschsprachige Teilnehmer. Um die Sprache anzugeben, in der das Dokument verfasst ist, verwenden Sie stattdessen das lang-Attribut.

Wenn kein Content-Language angegeben ist, wird standardmäßig davon ausgegangen, dass der Inhalt für alle Sprachzielgruppen gedacht ist. Mehrere Sprach-Tags sind ebenfalls möglich, ebenso wie die Anwendung des Content-Language-Headers auf verschiedene Medientypen und nicht nur auf Textdokumente.

Headertyp Repräsentations-Header
Verbotener Header-Name Nein
CORS-safelisted Response-Header Ja
CORS-safelisted Request-Header Ja*

* Werte dürfen 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 Sequenz von einem oder mehreren gross-/kleinunabhängigen 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 die Reichweite dieser Sprache verfeinern oder einschränken (z. B. en-CA = die Variante des Englisch, wie sie in Kanada gesprochen wird).

Hinweis: Sprach-Tags sind formal in BCP 47 definiert, die auf den ISO 639-Standard (oft die ISO 639-1 Code-Liste) für Sprachcodes angewiesen sind.

Beispiele

Die Sprache angeben, in der ein Dokument verfasst ist

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

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

Verwenden Sie nicht dieses Meta-Element, um die Dokumentsprache anzugeben, wie unten gezeigt:

html
<meta http-equiv="content-language" content="de" />

Eine Zielgruppe für eine Ressource angeben

Der Content-Language-Header wird verwendet, um die vorgesehene Zielgruppe der Seite zu spezifizieren und kann angeben, dass dies mehr als eine Sprache ist.

http
Content-Language: de, en

Spezifikationen

Specification
HTTP Semantics
# field.content-language

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch