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

CKTIS / HTML

Commentaires HTML : `<!--` et `-->`

Les commentaires HTML permettent de laisser des notes dans le code source ou de désactiver temporairement une portion de balisage sans la supprimer. Le navigateur ne les affiche pas sur la page, mais ils restent lisibles dans le code source.

Version : HTML Living Standard

Syntaxe

<!-- comment text -->

Un commentaire HTML s’ouvre avec <!-- et se ferme avec -->. Entre les deux, on peut mettre une ligne, plusieurs lignes ou aucun texte. Un commentaire sert à expliquer un choix de balisage ou à désactiver temporairement une portion de balisage.

Le navigateur n’affiche pas le commentaire. Le balisage qu’il contient reste du texte de commentaire et ne crée pas d’éléments. Le commentaire lui-même est un nœud Comment du DOM, et non un élément HTML. Il est lisible dans le code source de la page : n’y mettez donc aucun mot de passe ni aucune autre information confidentielle.

On peut placer un commentaire entre deux paragraphes, par exemple, mais pas à l’intérieur d’une balise ouvrante ni d’une valeur d’attribut. Dans title et textarea, ces délimiteurs ne créent pas de commentaires HTML. Pour le JavaScript dans script et le CSS dans style, utilisez la syntaxe de commentaire du langage concerné.

N’imbriquez pas les commentaires. Le texte d’un commentaire ne peut pas commencer par > ou ->, contenir <!--, --> ou --!>, ni se terminer par <!-. La séquence -- seule n’est pas interdite en HTML, mais elle l’est en XML.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>HTML comments</title>
</head>
<body>
  <!-- This note is for people reading the source. -->
  <p>Visible paragraph.</p>
  <!--
    <p>Commented-out paragraph.</p>
  -->
</body>
</html>

Résultat

Visible paragraph.

La page ne devrait afficher que `Visible paragraph.`. Consultez le code source pour retrouver la note et le paragraphe mis en commentaire. Dans le DOM, le balisage du deuxième paragraphe fait partie d’un commentaire : ce n’est pas un élément `p` distinct.

Leçons associées

  • HTML · Leçon 33 · Débutant · Version : 2

Sources