L'élémentHTML<meta> représente toute information demé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'attributname est défini, l'élément<meta> fournit desmétadonnées au niveau du document qui s'appliquent à toute la page.
• Si l'attributhttp-equiv est défini, l'élément<meta> agit comme unedirective pragma pour simuler des directives qui pourraient autrement être données par un en-tête HTTP.
• Si l'attributcharset est défini, l'élément<meta> est unedéclaration d'encodage, indiquant l'encodage des caractères utilisé dans le document.
• Si l'attributitemprop est défini, l'élément<meta> fournit desmétadonnées définies par l'utilisateur·ice.

Attributs

Cet élément inclutles attributs universels.

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'attributhttp-equiv ouname, 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'attributmedia définit à quel média la couleur de thème définie dans l'attributcontent doit s'appliquer. Sa valeur est unerequête média, qui prend la valeur par défaut « all » si l'attribut est absent. Cet attribut n'est pertinent que lorsque l'attributname de l'élément est défini àtheme-color. Sinon, il n'a aucun effet et ne doit pas être inclus.

name

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

Exemples

Définir une méta description

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

<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 utilisehttp-equiv="refresh" pour demander au navigateur d'effectuer une redirection.L'attributcontent="3;url=https://www.mozilla.org" redirigera la page vershttps://www.mozilla.org après 3 secondes :

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

Résumé technique

Spécifications

Compatibilité des navigateurs

Voir aussi

• Les noms des métadonnées standard
• Apprendre à utiliser<meta>