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 Darstellungsheader wird verwendet, um die Sprache(n) zu beschreiben, die für das Zielpublikum bestimmt sind, damit Benutzer sie gemäß ihrer eigenen bevorzugten Sprache unterscheiden können.
Zum Beispiel zeigt Content-Language: de-DE an, dass das Dokument für deutschsprachige Leser bestimmt 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, wird standardmäßig angenommen, 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 textuelle Dokumente.
| Header-Typ | Darstellungsheader |
|---|---|
| Verbotener Anfrageheader | Nein |
| CORS-safelisted Antwortheader | Ja |
| CORS-safelisted Anfrageheader | 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 Sequenz von einem oder mehreren nicht case-sensitiven 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 allgemeine Familie verwandter Sprachen identifiziert (z.B.en= Englisch) und wird optional gefolgt von einer Reihe von Subtags, die den Bereich dieser Sprache verfeinern 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 (häufig die ISO 639-1 Code-Liste) für Sprachcodes stützen.
Beispiele
Die Sprache eines Dokuments angeben
Das globale lang Attribut wird auf HTML-Elementen verwendet, um die Sprache eines gesamten HTML Dokuments oder 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" />
Ein Zielpublikum für eine Ressource angeben
Der Content-Language Header wird verwendet, um das beabsichtigte Publikum einer Seite zu spezifizieren und kann angeben, dass dies mehr als eine Sprache umfasst.
Content-Language: de, en
Spezifikationen
| Specification |
|---|
| HTTP Semantics # field.content-language |
Browser-Kompatibilität
BCD tables only load in the browser