dom : DOM Level 1 |
Attributs | Méthodes | Constantes | Interfaces | IDL | + |
Interface: Document
Description: L'interface Document représente tout le document HTML et XML. Elle représente la racine de l'arbre et permet d'accéder à toutes les données du document.
Hérite de: Node
Sous-Interfaces: html::HTMLDocument
Puisque les éléments, le texte, les commentaires, les instructions de processus ne peuvent pas exister à l'extérieur du document, l'interface du Document contient des méthodes "Factory" pour créer ces objets. Les noeuds créés possèdent un attribut ownerDocument qui les associe au document dans lequel il ont été créer.
Exemple
/* Afficher les objets du document */
var s='';
var o=document;
for ( var e in o ) {
s += e;
if ( typeof o[e] !='function')
s += ':'+o[e];
s +=', ';
}
alert(s);
Attributs
| Lecture Seule | Type | Nom | Description |
|---|---|---|---|
| OUI | NamedNodeMap | attributes |
Un objet NamedNodeMap contenant tous les attributs du noeud (si le noeud est un Element). |
| OUI | NodeList | childNodes |
Un NodeList contient tous les enfants du noeud. S'il n'y a pas d'enfant, le NodeList existe mais ne contient aucun noeud. (NodeList.length=0) |
| OUI | DocumentType | doctype |
La déclaration du type du document (DOCTYPE) associée avec ce document. La valeur est null pour les documents sans DOCTYPE.
|
| OUI | Element | documentElement |
C'est un attribut commode pour accéder directement à la racine du document (qui est un noeud enfant). Pour les documents HTML, il correspond à la balise HTML. |
| OUI | Node | firstChild |
Le premier noeud enfant de ce noeud. S'il n'y a pas d'enfant, retourne null. |
| OUI | DOMImplementation | implementation |
L'objet DOMImplementation définit les modules qui gère ce document. Une application DOM peut utilisé plusieurs objets provenants de plusieurs implémentations.HTML, XML |
| OUI | Node | lastChild |
Le dernier noeud enfant de ce noeud. S'il n'y a pas d'enfant, retourne null. |
| OUI | Node | nextSibling |
Le noeud qui suit immédiatement (après) le noeud courant. S'il n'existe pas, l'attribut est null. |
| OUI | DOMString | nodeName |
Le nom du noeud. Voir la table (interface Node). |
| OUI | unsigned short | nodeType |
Un code (entier) qui représente le type de noeud. |
| DOMString | nodeValue |
La valeur d'un noeud selon le type de Noeud. (Voir la table dans l'interface Node). |
|
| OUI | Document | ownerDocument |
L'objet Document associé à un noeud. C'est aussi l'objet permettant de créer de nouveaux noeuds. Lorsque ce noeud est un Document, l'attribut est null. |
| OUI | Node | parentNode |
Le parent du noeud. Tous les noeuds peuvent avoir un noeud parent. Exception faite de : Document, DocumentFragment et Attr. |
| OUI | Node | previousSibling |
Le noeud précédent immédiatement le noeud courant. S'il n'existe pas, l'attribut est null. |
Méthodes
| Retour | Nom | Description |
|---|---|---|
| Node | appendChild |
Ajoute un noeud newChild à la fin de la liste des enfants du noeud courant. Si newChild est déjà dans l'arbre, il est premièrement enlevé. |
| Node | cloneNode |
Retourne un clone d'un noeud. On peut s'en servir pour construire des copies conforme de noeuds. Le nouveau noeud n'a pas de parent (parentNode=null). |
| Attr | createAttribute |
Créer un noeud Attr avec le nom spécifié. On peut alors utiliser l'attribut avec la méthode Element.setAttributeNode(). |
| CDATASection | createCDATASection |
Crée une noeud CDATASection avec la valeur passée en paramètre. |
| Comment | createComment |
Crée un noeud Comment (de commentaires) avec le texte passé en paramètre. |
| DocumentFragment | createDocumentFragment |
Crée un objet DocumentFragment vide (sans enfant). |
| Element | createElement |
Crée un élément du type spécifié. Noter que l'élément créé implémente l'interface propre à l'élément. |
| EntityReference | createEntityReference |
Crée un objet EntityReference : &name; . |
| ProcessingInstruction | createProcessingInstruction |
Crée un noeud ProcessingInstruction avec le nom et la chaîne spécifiés. |
| Text | createTextNode |
Crée un noeud Text avec la chaîne spécifiée. |
| NodeList | getElementsByTagName |
Retourne un NodeList de tous les éléments avec le nom de balise spécifié dans l'ordre qu'on les rencontre dans l'arbre du Document. |
| boolean | hasChildNodes |
C'est une méthode utile pour déterminer si un noeud possède des noeud-enfants. |
| Node | insertBefore |
Insère le noeud newChild avant le noeud-enfant existant refChild. Si refChild est null, le nouveau noeud est insérer à la fin de la liste des noeud-enfants. |
| Node | removeChild |
Enlève un noeud-enfant indiqué par oldChild de la liste des enfants, et le retourne. |
| Node | replaceChild |
Remplace l'ancien noeud (oldChild) avec le nouveau noeud (newChild) et retourne l'ancien noeud (oldChild). |
Constantes
| ELEMENT_NODE | 1 | Le noeud est un Element |
| DOCUMENT_TYPE_NODE | 10 | Le noeud est un DocumentType |
| DOCUMENT_FRAGMENT_NODE | 11 | Le noeud est un DocumentFragment |
| NOTATION_NODE | 12 | Le noeud est une Notation |
| ATTRIBUTE_NODE | 2 | Le noeud est un Attr |
| TEXT_NODE | 3 | Le noeud est un Text |
| CDATA_SECTION_NODE | 4 | Le noeud est une CDATASection |
| ENTITY_REFERENCE_NODE | 5 | Le noeud est une EntityReference |
| ENTITY_NODE | 6 | Le noeud est une Entity |
| PROCESSING_INSTRUCTION_NODE | 7 | Le noeud est une ProcessingInstruction |
| COMMENT_NODE | 8 | Le noeud est un Comment |
| DOCUMENT_NODE | 9 | Le noeud est un Document |
Notes et commentaires des visiteurs
Ajouter une note
Aucun commentaire jusqu'à présent.