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.
L'en-tête Content-Language est utilisé pour décrire quels langages sont destinés au public, de sorte que cela permette à l'utilisateur de se différencier en fonction de la langue préférée des utilisateurs.
Par exemple, si "Content-Language: de-DE" est mis en place, cela signifie que la page est destinée à un public parlant l'allemand (par contre, cela n'indique pas que la page est écrite en allemand. Par exemple, elle pourrait être écrite en anglais dans le cadre d'un cours de langue destiné aux allemands).
Si l'en-tête Content-Language n'est pas spécifié, par défaut, cela signifie que la page est destinée à tout public de langue. Plusieurs tags de langue sont également possibles, ainsi que la mise en place de l'en-tête Content-Language pour dfférents types de médias, et pas seulement pour les documents texte.
| Type d'en-tête | Entity header |
|---|---|
| Forbidden header name | Non |
| CORS-safelisted response-header | Oui |
| CORS-safelisted request-header |
Oui, avec comme restriction supplémentaire que les valeurs ne peuvent
contenir que les
caractères 0-9, A-Z, a-z,
l'espace ou *,-.;=.
|
Syntaxe
Content-Language: de-DE Content-Language: en-US Content-Language: de-DE, en-CA
Directives
language-tag-
Plusieurs tags de langue sont séparés par paragraphe. Chaque tag de langue est une séquence d'un ou plusieurs sous-tags insensibles à la casse, chacun séparé par un tiret ("
-",%x2D). Dans la plupart des cas, un tag de langue se compose d'un sous-tag de langue principal qui identifie une large famille de langues connexes (par exemple, «en» = anglais), suivi éventuellement d'une série de sous-tags qui affinent ou réduisent la variété de langue. (par exemple, "en-CA" = la variété d'anglais telle que communiquée au Canada).
Note : Les tags de langues sont formellement définis dans la RFC 5646, qui repose sur la norme ISO 639 (très souvent la liste de codes ISO 639-1) pour les codes de langue à utiliser.
Exemples
Indiquer la langue dans laquelle un document est écrit
L'attribut global lang est utilisé sur des éléments HTML pour indiquer la langue d'une page HTML entière ou une partie de celle-ci.
<html lang="de"></html>
N'utilisez pas le meta tag comme ceci pour déclarer la langue d'un document:
<!-- /!\ C'est une mauvaise pratique -->
<meta http-equiv="content-language" content="de" />
Indiquer un public cible pour une ressource
L'en-tête Content-Language est utilisé pour spécifier le public destiné à la page, et peut indiquer si cela est plus qu'une seule langue.
Content-Language: de, en
Spécifications
| Specification |
|---|
| HTTP Semantics # field.content-language |
Compatibilité des navigateurs
BCD tables only load in the browser