<meta> : l'élément de métadonnées du document

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'élément HTML <meta> représente toute information de métadonnées qui ne peut pas être représentée par un des autres éléments de métadonnées (<base>, <link>, <script>, <style> ou <title>).

<meta> peut fournir différents types de métadonnées :

  • Si l'attribut name est défini, l'élément <meta> définit alors une métadonnée du document, s'appliquant à toute la page.
  • Si l'attribut http-equiv est défini, l'élément <meta> est une directive de pragma, fournissant une information équivalente à celle qui peut être indiquée par l'en-tête HTTP homonyme.
  • Si l'attribut charset est défini, l'élément <meta> constitue une déclaration de jeu de caractères, et indique l'encodage des caractères du document.
  • Si l'attribut itemprop est défini, l'élément <meta> fournit une métadonnée spécifique au site.

Attributs

Comme tous les autres éléments, cet élément inclut les attributs universels.

Note : Il faut préciser que l'attribut name possède une signification spécifique pour l'élément <meta> et que l'attribut itemprop ne doit pas être utilisé quand l'un de ces attributs suivant est déjà défini : name, http-equiv ou charset.

charset

Cet attribut indique l'encodage des caractères pour le document. Si cet attribut est présent, sa valeur doit correspondre (quelle que soit la casse) à "utf-8". En effet, seul UTF-8 est valide pour encoder des documents HTML depuis HTML5. Les éléments <meta> qui déclarent un encodage doivent apparaître complètement au sein des 1024 premiers octets du document.

content

Cet attribut fournit la valeur associée avec l'attribut http-equiv ou l'attribut name suivant le contexte utilisé.

http-equiv

Cet attribut définit une directive de pragma. Il est nommé http-equiv(alent), car les valeurs autorisées suivantes sont les noms d'en-têtes HTTP correspondant.

content-security-policy

Cette valeur permet de créer des règles de gestion de contenu (CSP) pour les ressources qui sont servies. Cela permet notamment d'indiquer les origines valides et les points d'accès aux scripts afin de protéger contre les attaques XSS.

content-type

Ce champ d'attribut définit le type MIME du document, suivi du jeu de caractères utilisé pour l'encodage du document. Si cette valeur est utilisée, l'attribut content doit valoir "text/html; charset=utf-8". Cette formulation est équivalente à un élément <meta> ayant l'attribut charset, et les mêmes restrictions s'appliquent quant à l'emplacement dans le document (1024 premiers octets).

Note : Cette valeur peut uniquement être utilisée pour les documents servis avec le type text/html. Elle ne peut pas être utilisée pour les documents servis avec un type MIME XML.

default-style

Le nom de la feuille de style CSS par défaut.

x-ua-compatible

Si cette valeur est fournie, l'attribut content doit valoir "IE=edge". Les agents utilisateur doivent ignorer cette directive.

refresh

Ce champ définit :

  • Le nombre de secondes qu'il faudrait attendre avant de recharger la page si l'attribut content contient seulement un nombre entier positif.
  • Le nombre de secondes qu'il faudrait attendre avant que la page soit redirigée vers une autre page, si l'attribut content contient un nombre entier positif suivi par la chaîne de caractères ';url=' ainsi qu'une URL valide. Voir la section sur l'accessibilité ci-après.
name

Cet attribut définit le nom d'une métadonnée au niveau du document, l'attribut content portant alors la valeur correspondante. Voir la page sur les noms des métadonnées standard pour plus de détails à propos des noms de métadonnées standard définis dans la spécification HTML.

Exemples

html
<meta charset="utf-8" />

<!-- Rediriger la page après 3 secondes -->
<meta http-equiv="refresh" content="3;url=https://www.mozilla.org" />

Accessibilité

Les pages utilisant refresh risquent d'utiliser un intervalle de temps trop court. Les personnes utilisant des outils d'assistance comme des lecteurs d'écran pourraient être incapables d'analyser le contenu de la page courante avant la redirection. La mise à jour abrupte et sans avertissement de la page peut également désorienter les personnes en situation de handicap visuel.

Résumé technique

Catégories de contenu Contenu de métadonnées. Si l'attribut itemprop est utilisé : du contenu de flux ou du contenu phrasé.
Contenu autorisé Aucun, cet élément est un élément vide.
Omission de balises Étant un élément vide, la balise de début doit être présente et la balise de fin doit être absente.
Éléments parents autorisés
  • <meta charset>, <meta http-equiv> : un élément <head>. Si l'attribut http-equiv n'est pas une déclaration d'encodage, l'élément peut également être au sein d'un élément <noscript> lui-même contenu dans un élément <head>.
  • <meta name> : tout élément acceptant du contenu de métadonnées.
  • <meta itemprop> : tout élément acceptant du contenu de métadonnées ou du contenu de flux.
    • Rôle ARIA implicite Aucun rôle correspondant
    Rôles ARIA autorisés Aucun.
    Interface DOM HTMLMetaElement

    Spécifications

    Specification
    HTML Standard
    # the-meta-element

    Compatibilité des navigateurs

    BCD tables only load in the browser

    Voir aussi