HTML
commentaires
Recherche…
Introduction
Semblables aux autres langages de programmation, de balisage et de démarquage, les commentaires en HTML fournissent aux autres développeurs des informations spécifiques au développement sans affecter l'interface utilisateur. Contrairement aux autres langages, les commentaires HTML peuvent être utilisés pour spécifier des éléments HTML uniquement pour Internet Explorer. Cette rubrique explique comment écrire des commentaires HTML et leurs applications fonctionnelles.
Syntaxe
<!-- Comment text -->
Remarques
Tout ce qui commence par <!--
et se termine par -->
est un commentaire. Les commentaires ne peuvent pas contenir deux tirets adjacents ( --
) et doivent se terminer par deux tirets exactement (c.-à-d. --->
n'est pas correct).
Les commentaires ne sont pas visibles sur une page Web et ne peuvent pas être stylés avec CSS. Ils peuvent être utilisés par le développeur de la page pour prendre des notes dans le code HTML ou pour masquer certains contenus lors du développement.
Pour les pages dynamiques ou interactives, masquer et afficher du contenu se fait avec JavaScript et CSS plutôt qu'avec des commentaires HTML.
JavaScript peut être utilisé pour obtenir le contenu des nœuds de commentaire HTML et ces nœuds peuvent être créés, ajoutés et supprimés dynamiquement du document, mais cela n'affecte pas l'affichage de la page.
Les commentaires HTML faisant partie du code source de la page, ils sont téléchargés dans le navigateur avec le reste de la page. Le code source peut généralement être visualisé à l'aide de l'option de menu du navigateur Web: "Afficher la source" ou "Afficher la source de la page".
Créer des commentaires
Les commentaires HTML peuvent être utilisés pour laisser des notes à vous-même ou à d'autres développeurs sur un point spécifique du code. Ils peuvent être initiés avec <!--
et conclus avec -->
, comme ceci:
<!-- I'm an HTML comment! -->
Ils peuvent être intégrés en ligne dans d'autres contenus:
<h1>This part will be displayed <!-- while this will not be displayed -->.</h1>
Ils peuvent également couvrir plusieurs lignes pour fournir plus d'informations:
<!-- This is a multiline HTML comment.
Whatever is in here will not be rendered by the browser.
You can "comment out" entire sections of HTML code.
-->
Cependant, ils ne peuvent pas apparaître dans une autre balise HTML, comme ceci:
<h1 <!-- testAttribute="something" -->>This will not work</h1>
Ce produit HTML invalide l'ensemble <h1 <!-- testAttribute="something" -->
bloc serait considéré comme une seule balise de début h1
avec d'autres informations non valides qu'il contient, suivi d'un seul >
support de fermeture qui ne fait rien.
Pour des raisons de compatibilité avec les outils qui tentent d’analyser HTML au format XML ou SGML, le corps de votre commentaire ne doit pas contenir deux tirets --
.
Commentaires conditionnels pour Internet Explorer
Les commentaires conditionnels peuvent être utilisés pour personnaliser le code de différentes versions de Microsoft Internet Explorer. Par exemple, différentes classes HTML, balises de script ou feuilles de style peuvent être fournies. Les commentaires conditionnels sont pris en charge dans les versions 5 à 9 d'Internet Explorer. Les versions Internet Explorer plus anciennes et plus récentes, ainsi que tous les navigateurs autres qu'IE, sont considérés comme "de bas niveau" et traitent les commentaires conditionnels comme des commentaires HTML ordinaires.
Caché de bas
Les commentaires cachés au niveau inférieur fonctionnent en encapsulant l'intégralité du contenu dans ce qui semble être un commentaire HTML normal. Seuls les IE 5 à 9 le liront toujours comme un commentaire conditionnel et ils masqueront ou afficheront le contenu en conséquence. Dans d'autres navigateurs, le contenu sera caché.
<!--[if IE]>
Revealed in IE 5 through 9. Commented out and hidden in all other browsers.
<![endif]-->
<!--[if lt IE 8]>
Revealed only in specified versions of IE 5-9 (here, IE less than 8).
<![endif]-->
<!--[if !IE]>
Revealed in no browsers. Equivalent to a regular HTML comment.
<![endif]-->
<!--
For purposes of comparison, this is a regular HTML comment.
-->
Niveau inférieur révélé
Celles-ci sont légèrement différentes des commentaires cachés au niveau inférieur: seul le commentaire conditionnel lui-même est contenu dans la syntaxe de commentaire normale. Les navigateurs qui ne prennent pas en charge les commentaires conditionnels les ignorent simplement et affichent le reste du contenu entre eux.
<!--[if IE]>-->
The HTML inside this comment is revealed in IE 5-9, and in all other browsers.
<!--<![endif]-->
<!--[if IE 9]>-->
This is revealed in specified versions of IE 5-9, and in all other browsers.
<!--<![endif]-->
<!--[if !IE]>-->
This is not revealed in IE 5-9. It's still revealed in other browsers.
<!--<![endif]-->
Commenter les espaces entre les éléments en ligne
Les éléments d'affichage en ligne, généralement tels que span
ou a
, incluront jusqu'à un caractère blanc avant et après le document. Pour éviter les lignes très longues dans le balisage (difficiles à lire) et les espaces blancs involontaires (qui affectent le formatage), l'espace blanc peut être mis en commentaire.
<!-- Use an HTML comment to nullify the newline character below: -->
<a href="#">I hope there will be no extra whitespace after this!</a><!--
--><button>Foo</button>
Essayez-le sans commentaire entre les éléments en ligne, et il y aura un espace entre eux. Parfois, ramasser le caractère d'espace est désiré.
Exemple de code:
<!-- Use an HTML comment to nullify the newline character below: -->
<a href="#">I hope there will be no extra whitespace after this!</a><!--
--><button>Foo</button>
<hr>
<!-- Without it, you can notice a small formatting difference: -->
<a href="#">I hope there will be no extra whitespace after this!</a>
<button>Foo</button>
Sortie: