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 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
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 lang="de">
…
</html>
Verwenden Sie nicht dieses Meta-Element, um die Dokumentsprache anzugeben, wie unten gezeigt:
<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.
Content-Language: de, en
Spezifikationen
Specification |
---|
HTTP Semantics # field.content-language |
Browser-Kompatibilität
BCD tables only load in the browser