Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

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

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨juillet 2015⁩.

* Some parts of this feature may have varying levels of support.

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, tels que <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> fournit des métadonnées au niveau du document qui s'appliquent à toute la page.
  • Si l'attribut http-equiv est défini, l'élément <meta> agit comme une directive pragma pour simuler des directives qui pourraient autrement être données par un en-tête HTTP.
  • Si l'attribut charset est défini, l'élément <meta> est une déclaration d'encodage, indiquant l'encodage des caractères utilisé dans le document.
  • Si l'attribut itemprop est défini, l'élément <meta> fournit des métadonnées définies par l'utilisateur·ice.

Attributs

Cet élément inclut les attributs universels.

Note : L'attribut name possède une signification spécifique pour l'élément <meta>. L'attribut itemprop ne doit pas être utilisé sur un élément <meta> qui inclut un attribut 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 », car UTF-8 est le seul encodage valide pour les documents HTML5. Les éléments <meta> qui déclarent un encodage doivent apparaître entièrement dans les 1024 premiers octets du document.

content

Cet attribut fournit la valeur associée à l'attribut http-equiv ou name, selon le contexte d'utilisation.

http-equiv

Définit une directive de pragma, c'est-à-dire une instruction pour le navigateur concernant le traitement du document. Le nom de l'attribut est l'abréviation de « http-equivalent », car les valeurs autorisées correspondent aux noms d'en-têtes HTTP équivalents.

media

L'attribut media définit à quel média la couleur de thème définie dans l'attribut content doit s'appliquer. Sa valeur est une requête média, qui prend la valeur par défaut « all » si l'attribut est absent. Cet attribut n'est pertinent que lorsque l'attribut name de l'élément est défini à theme-color. Sinon, il n'a aucun effet et ne doit pas être inclus.

name

Les attributs name et content peuvent être utilisés ensemble pour fournir des métadonnées au document sous forme de paires nom-valeur, l'attribut name donnant le nom de la métadonnée et l'attribut content sa valeur.

Exemples

Définir une méta description

La balise <meta> suivante fournit une description comme métadonnée pour la page web :

html
<meta
  name="description"
  content="La référence HTML décrit tous les éléments et attributs HTML, y compris les attributs globaux qui s'appliquent à tous les éléments." />

Définir une redirection de page

L'exemple suivant utilise http-equiv="refresh" pour demander au navigateur d'effectuer une redirection. L'attribut content="3;url=https://www.mozilla.org" redirigera la page vers https://www.mozilla.org après 3 secondes :

html
<meta http-equiv="refresh" content="3;url=https://www.mozilla.org" />

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.
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 (angl.)
    Rôles ARIA autorisés Aucun.
    Interface DOM HTMLMetaElement

    Spécifications

    Specification
    HTML
    # the-meta-element

    Compatibilité des navigateurs

    Voir aussi