En-tête Content-Language
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
L'en-tête de représentation HTTP Content-Language est utilisé pour décrire la ou les langues destinées au public, afin que les utilisateur·ice·s puissent la différencier selon leur propre langue préférée.
Par exemple, Content-Language: de-DE indique que le document est destiné aux personnes germanophones. Le document peut être rédigé en anglais, et non en allemand, dans le cadre d'un cours de langue pour germanophones. Pour indiquer la langue dans laquelle le document est rédigé, utilisez plutôt l'attribut lang.
Si aucun Content-Language n'est défini, la valeur par défaut est que le contenu est destiné à tous les publics linguistiques. Plusieurs tags de langue sont également possibles, ainsi qu'une application de l'en-tête Content-Language à divers types de médias et pas seulement aux documents textuels.
| Type d'en-tête | En-tête de représentation |
|---|---|
| En-tête de requête interdit | Non |
| En-tête de réponse autorisé CORS | Oui |
| En-tête de requête autorisé CORS | Oui* |
* Les valeurs ne peuvent contenir que les caractères 0-9, A-Z, a-z, un espace ou les caractères *,-.;=.
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 une virgule. Chaque tag de langue est une séquence d'un ou plusieurs sous-tags insensibles à la casse, chacun séparé par un tiret (
-). Dans la plupart des cas, un tag de langue se compose d'un sous-tag 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 langue sont formellement définis selon les balises de langue BCP 47, qui reposent sur la norme ISO 639 (très souvent la liste des 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 l'élément HTML meta comme ceci pour déclarer la langue d'un document :
<meta http-equiv="content-language" content="de" />
Indiquer un public cible pour une ressource
L'en-tête Content-Language est utilisé pour définir le public cible de la page et peut indiquer qu'il s'agit de plusieurs langues.
Content-Language: de, en
Spécifications
| Specification |
|---|
| HTTP Semantics> # field.content-language> |