Content-Language

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
<html lang="de"></html>

N'utilisez pas le meta tag comme ceci pour déclarer la langue d'un document:

html
<!-- /!\ 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

Voir aussi