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

CKTIS / HTML

head — métadonnées du document HTML

L’élément `head` regroupe les métadonnées du document, telles que son titre et la déclaration de son encodage des caractères. C’est le premier élément enfant de `html`, avant `body`.

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

Syntaxe

<head>
  <meta charset="utf-8">
  <title>Document title</title>
</head>

head représente un ensemble de métadonnées du document. Dans html, il précède body. Il ne faut pas le confondre avec un titre visible dans la page : le contenu de la page appartient à body, tandis que title définit le titre du document.

Le contenu de head doit être constitué de métadonnées ; title, meta, link, style et script en sont des exemples. En règle générale, un seul élément title est requis. Il peut être omis dans un document iframe utilisant srcdoc, ou lorsque le titre est fourni par un protocole de niveau supérieur. Dans les deux cas, un seul élément base au maximum est autorisé.

head prend en charge les attributs globaux. En syntaxe text/html, ses balises ne peuvent être omises que sous certaines conditions ; dans l’exemple, elles sont toutes deux écrites explicitement pour rendre la structure claire.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Head demo</title>
</head>
<body>
  <p>Page content</p>
  <script>
    const head = document.head;
    const charset = head.querySelector('meta[charset]');
    console.log('Head is the first element in html: ' + (document.documentElement.firstElementChild === head));
    console.log('Title in document metadata: ' + document.title);
    console.log('Charset declared in head: ' + charset.getAttribute('charset'));
  </script>
</body>
</html>

Résultat

Head is the first element in html: true
Title in document metadata: Head demo
Charset declared in head: utf-8

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