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

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⁩.

* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.

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" />