Méthode XML DOM getElementById()
Définition et utilisation
La méthode getElementById() recherche l'élément avec un ID spécifique unique.
Syntaxe :
getElementById(elementid)
| Paramètres | Description |
|---|---|
| elementid | la valeur de l'attribut id de l'élément que vous souhaitez obtenir. |
Valeur de retour
représente le noeud Element de l'élément de document spécifié avec l'attribut id. Si aucun tel élément n'est trouvé, il renvoie null.
Description
Cette méthode recherche l'attribut id avec la valeur elementid du noeud d'élément, et le renvoie. Si aucun tel élément n'est trouvé, il renvoie null. La valeur de l'attribut id est unique dans le document, si cette méthode trouve plus d'éléments avec l'attribut elementid du noeud d'élément, il renvoie aléatoirement un tel noeud d'élément ou renvoie null.
C'est une méthode courante importante, car elle fournit un moyen simple d'obtenir l'objet Element représentant l'élément de document spécifié.
Attention :Le nom de cette méthode se termine par Id, pas ID, ne pas se tromper.
Dans un document HTML, cette méthode recherche toujours l'attribut id spécifié. Il est possible d'utiliser Méthode getElementByName() de HTMLDocument, selon la valeur de leur attribut name.
Dans un document XML, cette méthode utilise un attribut de type id pour rechercher, peu importe le nom de cet attribut. Si le type de l'attribut XML est inconnu (par exemple, le lecteur XML l'a ignoré ou ne peut pas localiser le DTD du document), cette méthode retourne toujours null. Dans JavaScript client, cette méthode n'est pas souvent utilisée avec des documents XML. En fait, getElementById() a été initialement défini comme un membre de l'interface HTMLDocument, mais a été déplacé dans l'interface Document dans le niveau 2 du DOM.
