| comment, Comment | NN 6 IE 4 DOM 1 | |||||||
L'objet comment représente l'élément ! dans un document HTML. Mais dans un environnement de DOM W3C, tel que Netscape 6, cet objet n´est pas un véritable élément dans le contexte du modèle abstrait du DOM W3C. En fait, l´objet est simplement un type de noeud spécial. Un tel noeud a une valeur nodeType de 8, ce qui l´identifie comme un noeud Comment. Un noeud Comment a la chaîne d´héritage suivante dans le modèle abstrait du DOM: Node->CharacterData->Comment. Alors que des valeurs spéciales sont automatiquement affectées à certaines propriétés (telles que nodeValue) d´un noeud Comment, un noeud Comment n´a pas d´autres propriétés ou méthodes que celles héritées des objets Node et CharacterData. Les propriétés et méthodes Node sont couvertes précédemment dans ce chapitre en tant qu´éléments partagés; les propriétés et méthodes CharacterData sont couvertes en détail avec l´objet Text, qui hérite aussi de CharacterData et qui a de fortes chances d´être défini par script. |
||||||||
Pour référencer un élément de commentaire, utilisez les propriétés d´élément relatif ou de noeud. Alors qu´IE fournit une propriété id via son modèle d´héritage, vous ne pouvez pas associer d´identificateur à l´élément via un attribut id. Cependant, un tel élément dans IE a une valeur de nom de balise de !. Ainsi, vous pouvez référencer un élément de commentaire HTML IE avec la collection d´éléments renvoyée par la méthode document.all.tags("!"). |
||||||||
| Equivalent HTML | ||||||||
<!--comment text-->
|
||||||||
| Référence de modèle d'objet | ||||||||
nodeReference
|
||||||||
| Propriétés spécifiques à l´objet | ||||||||
|
||||||||
| Méthodes spécifiques à l´objet | ||||||||
|
||||||||
| Propriétés de gestionnaire d´événements spécifiques à l´objet | ||||||||
Aucune. |
||||||||
| data | NN 6 IE 6 DOM 1 |
| Lecture/écriture | |
Fournit le contenu du texte du commentaire. Voir Text.data. |
|
| length | NN 6 IE 6 DOM 1 |
| Lecture seule | |
Fournit le nombre de caractères des données de commentaire. Voir Text.length. |
|
| text | NN s.o. IE 4 DOM 1 |
| Lecture/écriture | |
Fournit le contenu du texte de l´élément. En raison de la nature de cet élément, la valeur de la propriété text est identique aux valeurs des propriétés innerHTML et outerHTML. Les modifications apportées à cette propriété n'affectent pas le texte du commentaire affiché par le navigateur dans le code source du document. Cette propriété n'est pas disponible dans Internet Explorer 4 pour Macintosh. |
|
| Exemple | |
document.all.tags("!")[4].text = "Replaced comment, but no one will know.";
|
|
| Valeur | |
Chaîne. |
|
| Par défaut | |
Aucune. |
|
| appendData(), deleteData(), insertData(), replaceData(), substringData() | NN 6 IE 6 DOM 1 |
Fournissent les méthodes pour manipuler le texte de commentaire. Reportez-vous à ces méthodes dans l´objet Text. |
|