Les com­men­taires HTML sont des sections de texte à l’intérieur des documents HTML qui sont ignorées par le na­vi­ga­teur et ne s’affichent donc pas sur le site Web. Ils servent à rendre le code plus com­pré­hen­sible pour les dé­ve­lop­peurs, à laisser des remarques et à dé­sac­ti­ver tem­po­rai­re­ment certains passages du code.

Hé­ber­ge­ment Web
Hé­ber­ge­ment Web de pointe au meilleur prix
  • 3x plus rapide, 60 % d'éco­no­mie
  • Haute dis­po­ni­bi­lité >99,99 %
  • Seulement chez IONOS : jusqu'à 500 Go inclus

Que sont les com­men­taires HTML et comment en insérer ?

Un com­men­taire HTML est un marquage spécial qui permet aux pro­gram­meurs de laisser une sorte de note dans le code. Ces notes ne sont pas prises en compte par les na­vi­ga­teurs Web et sont donc in­vi­sibles pour les uti­li­sa­teurs finaux. Pour créer un com­men­taire en HTML, on utilise la syntaxe <!-- Contenu du commentaire -->. Vous trouverez ci-dessous un exemple simple qui montre comment insérer un com­men­taire dans un document HTML :

<!DOCTYPE html>
<html lang="fr">
<head>
    <meta charset="UTF-8">
    <title>Page d’exemple</title>
</head>
<body>
    <!-- Ceci est un commentaire. Il ne sera pas affiché dans le navigateur -->
    <h1>Titre H1</h1>
    <!-- <p>Ce texte ne s’affiche pas dans le navigateur.</p> -->
</body>
</html>
HTML

Dans l’exemple ci-dessus, le premier com­men­taire et celui autour du pa­ra­graphe HTML sont ignorés par le na­vi­ga­teur, de sorte que seul le texte à l’intérieur du titre HTML est affiché.

Notez qu’en HTML, il n’existe aucune syntaxe spé­ci­fique pour les com­men­taires mul­ti­lignes. On peut toutefois sim­ple­ment utiliser plusieurs lignes dans un seul com­men­taire. C’est par­ti­cu­liè­re­ment utile lorsque des ex­pli­ca­tions ou des notes plus longues sont né­ces­saires. Les com­men­taires mul­ti­lignes com­men­cent et se terminent comme les com­men­taires à une seule ligne, le texte entre les deux peut comporter autant de lignes que né­ces­saire.

Note

Les com­men­taires sont l’une des premières choses que vous ren­con­tre­rez lorsque vous ap­pren­drez le HTML. Pour en savoir plus sur les autres points à prendre en compte lorsque vous souhaitez pro­gram­mer des sites Web en HTML, consultez notre grand tutoriel HTML d’in­tro­duc­tion.

Pourquoi a-t-on besoin des com­men­taires HTML ?

Les com­men­taires HTML sont un outil essentiel dans le dé­ve­lop­pe­ment Web. Ils ont plusieurs fonctions im­por­tantes :

  • Do­cu­men­ter : les com­men­taires aident à do­cu­men­ter le code afin que d’autres dé­ve­lop­peurs ou le futur soi-même puissent com­prendre plus fa­ci­le­ment le but et le fonc­tion­ne­ment de certaines sections de code.
  • Dé­sac­ti­ver le code : les pro­gram­meurs peuvent dé­sac­ti­ver tem­po­rai­re­ment des parties de code ou des balises HTML sans avoir à les supprimer. Ceci est par­ti­cu­liè­re­ment utile lors de la recherche d’erreurs, du débogage ou de l’ex­pé­ri­men­ta­tion.
  • Être organisé : les grands documents HTML peuvent être struc­tu­rés et organisés grâce à l’uti­li­sa­tion de com­men­taires HTML. Cela facilite la na­vi­ga­tion et l’édition du code.
  • Annoter : les dé­ve­lop­peurs peuvent, si né­ces­saire, laisser des notes per­son­nelles dans le code.

Remarques im­por­tantes sur l’uti­li­sa­tion des com­men­taires HTML

Lors de l’uti­li­sa­tion d’un com­men­taire HTML, les pro­gram­meurs doivent tenir compte de certaines choses. En par­ti­cu­lier, aucun com­men­taire imbriqué n’est possible. Cela signifie qu’un com­men­taire ne peut pas être placé à l’intérieur d’un autre com­men­taire. Cela en­traî­ne­rait une erreur. L’exemple suivant illustre ce point :

<!--
    Ceci est un commentaire.
    <!-- Ceci est un commentaire imbriqué et provoque une erreur. -->
-->
HTML

Lors de la rédaction de com­men­taires, il convient également de respecter certaines bonnes pratiques. En premier lieu, les com­men­taires doivent être clairs et concis afin d’améliorer la li­si­bi­lité du code ; les longs com­men­taires peuvent en effet rendre le code confus. Les com­men­taires superflus doivent être évités. De plus, dans le meilleur des cas, le code s’explique de lui-même. Les com­men­taires sont un com­plé­ment utile, mais ne rem­pla­cent pas un style de pro­gram­ma­tion propre.

Nom de domaine
Votre domaine en un clic
  • 1 cer­ti­fi­cat SSL Wildcard par contrat
  • Fonction incluse Domain Connect pour une con­fi­gu­ra­tion DNS sim­pli­fiée
Aller au menu principal