ACCUEIL |  PAGE PRECEDENTE |  PAGE SUIVANTE |  FIN DE PAGE |  INDEX

Commentaires <!-- ... --> Valid XHTML 1.0 Transitional



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 -->
   
 

ACCUEIL |  PAGE PRECEDENTE |  PAGE SUIVANTE |  DEBUT DE PAGE |  INDEX