<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
nameest 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-equivest 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
charsetest 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
itempropest 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-equivouname, 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
mediadéfinit à quel média la couleur de thème définie dans l'attributcontentdoit 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'attributnamede l'élément est défini àtheme-color. Sinon, il n'a aucun effet et ne doit pas être inclus. name-
Les attributs
nameetcontentpeuvent être utilisés ensemble pour fournir des métadonnées au document sous forme de paires nom-valeur, l'attributnamedonnant le nom de la métadonnée et l'attributcontentsa valeur.
Exemples
>Définir une méta description
La balise <meta> suivante fournit une description 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 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 :
<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
Chargement…