Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

meta — métadonnées d’un document HTML

L’élément meta enregistre des métadonnées telles que la description d’une page et une déclaration d’encodage. Il peut également spécifier des directives pragma ou des propriétés de microdonnées. Son sens dépend de l’attribut choisi.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<meta charset="utf-8">
<meta name="description" content="Page description">
<meta http-equiv="refresh" content="30">
<div itemscope>
  <meta itemprop="name" content="Example">
</div>

meta décrit un document au lieu de créer du contenu visible. C’est un élément vide : en HTML, il n’a ni contenu ni balise de fermeture. Il se place normalement dans head ; la variante avec itemprop est également autorisée là où un contenu phrasé est attendu.

Indiquez exactement l’un des attributs name, http-equiv, charset ou itemprop. name identifie des métadonnées telles que description ; http-equiv sélectionne une directive pragma ; charset déclare l’encodage ; itemprop identifie une propriété de microdonnées. content est requis pour les trois variantes autres que charset et doit être omis avec charset.

Utilisez charset="utf-8" et enregistrez réellement le fichier en UTF-8. La déclaration entière doit tenir dans les 1024 premiers octets. Un document ne peut contenir qu’une seule déclaration d’encodage fondée sur meta ; ne combinez pas charset avec l’alternative http-equiv="content-type". En XML, l’attribut charset est sans effet.

http-equiv ne remplace pas de manière générale les en-têtes HTTP. L’attribut media ne peut être utilisé qu’avec name="theme-color". Un document peut contenir au maximum une entrée description.

L’exemple lit le content de la description et l’affiche dans un paragraphe. L’élément meta lui-même n’affiche pas ce texte.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="description" content="A metadata demonstration.">
  <title>Metadata example</title>
</head>
<body>
  <p id="result"></p>
  <script>
    const description = document.querySelector('meta[name="description"]');
    document.getElementById('result').textContent = description.content;
  </script>
</body>
</html>

Résultat

A metadata demonstration.

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources