Commentaires <!-- ... -->
Utilisation
|
Permet..............
|
Balises de début/de fin
|
Nécessaire/nécessaire
|
Attributs
|
%coreattrs, %i18n, %events.
align="..." : deprecated. Contrôle l'alignement ( left, center, right, justify
)
|
Vide
|
Non
|
Remarques:
Les commentaires peuvent s'étendre sur plusieurs lignes.
La balise de fin ne doit pas nécessairement figurer sur la même ligne que la balise de début.
C'est la seule instruction autorisée en dehors de la balise <HTML>. Elle correspond au REM de
DOS.
Les commentaires peuvent être placés n'importe où dans un document.
Les commentaires permettent d'améliorer sensiblement la lisibilité du
document et d'en retrouver facilement tel ou tel passage, pour une modification éventuelle.
Exemples d'utilisation des commentaires :
Insertion d'une remarque :
<!-- insertion et encapsulation de l'image de fond
-->
<IMG id=LeFond
src="c:\temp\fondcroco.jpg" style="visibility:hidden;
position:absolute;top=0px;left=0px;z-index: -5">
<!-- insertion du son
-->
<BGSOUND id=LeBG
src="c:\temp\musjazz05.mid" balance=0 loop=999 volume=-700 src="">
Masquage de scripts :
<SCRIPT Language="JavaScript">
<!-- Masquer le script pour les navigateurs non compatibles
// Afficher "c'est OK !"
document/writeln("c'est OK ! <BR>");
// cesser de masquer le script -->
</SCRIPT>
______________________________
<SCRIPT Language="VBScript">
<!--
Sub Test_OnClick()
Dim Nombre
Dim Doubler
Doubler = Doubler(Nombre)
End Sub
Function Doubler(Nombre)
' Ce code est volontairement incorrect, il ne figure ici qu'à titre
d'exemple
Number = Number *2
Doubler = Number
END Function
-->
</SCRIPT>
________________________
Les balises HTML de commentaires ( en vert) sont utiles dans le cas où le navigateur qui lit la
page est incapable de lire JavaScript ou VBScript. L'ensemble du script sera alors
ignoré !
En bleu vert, il s'agit de commentaires dont JavaScript ou VBScript ne tiendront pas compte et
qui ne sont là que pour documenter l'utilisateur.
Il ne faut pas confondre ces deux types de commentaire :
' (VBScript) et // (JavaScript) introduisent des commentaires d'une seule
ligne
<!-- et --> : tout ce qui est contenu dans ce commentaire HTML sera
ignoré par l'interpréteur de script si le navigateur ne sait pas en faire usage.
Document additionnel ( Face cachée d'HTML ) :
|
<!-- (COMMENTAIRE) |
HTML |
Définition |
Permet d'introduire un commentaire sur une ou plusieurs lignes .
Cet attribut est optionnel. |
3.2 |
4.0 |
Syntaxe |
La syntaxe diffère selon le langage de script.
Exemple de commentaire JavaScript:
<SCRIPT type="text/javascript" >
<!-- première ligne du commentaire
texte du script.........
//-- dernière ligne du commentaire-->
</SCRIPT>
Exemple de commentaire VBscript:
<SCRIPT type="text/vbscript" >
<!-- première ligne du commentaire
texte du script.........
'-- dernière ligne du commentaire-->
</SCRIPT>
|
|
|
Note: |
L'objectif principal des commentaires est de dissimuler le contenu du script aux
navigateurs qui ne reconnaissent pas les scripts, afin que ceux-ci n'affichent pas
ce contenu comme du texte.
Les langages de scripts admettent des commentaires sur une ligne selon une
syntaxe qui leur est propre, mais reconnaissent tous la première ligne du
commentaire SGML introduite par <!-- . Ils ne reconnaissent pas par contre la
dernière ligne et celle-ci doit être remplacée par une ligne qu'ils
reconnaissent.
En conséquence, les commentaires doivent se présenter de la même manière quel
que soit le langage utilisé :
- Première ligne : <!-- première ligne de commentaire reconnue par les
langages
- Dernière ligne :
- JavaScript: // ligne de commentaire JavaScript -->
- VBscript : ' ligne de commentaire VBvascript -->
- Tcl : # ligne de commentaire Tcl -->
|
|
|