element

  • Raccourci de la révision : DOM/element
  • Titre de la révision : element
  • ID de la révision : 116130
  • Créé :
  • Créateur : BenoitL
  • Version actuelle ? Non
  • Commentaire mise à jour - première partie

Contenu de la révision

{{template.DomRef()}}

Ce chapitre fournit une brève référence des méthodes, propriétés et évènements généraux disponibles pour la plupart des éléments HTML et XML au sein du DOM des navigateurs utilisant Gecko.

Plusieurs spécifications du W3C s'appliquent aux éléments DOM :

Les articles listés ici couvrent ces différentes spécifications et fournissent des liens vers celles-ci aux endroits appropriés.

Bien que ces interfaces soient généralement partagées par la plupart des éléments HTML et XML, il en existe d'autres, plus spécialisées, pour des objets particuliers listés dans la spécification DOM HTML — par exemple les interfaces de l'élément HTML Table et de l'élément HTML Form.

Propriétés

Nom Description Type Disponibilité
attributes Tous les attributs associés à un élément. NamedNodeMap Toujours
childNodes Tous les nœuds enfants d'un élément. NodeList Toujours
className Définit ou obtient la classe de l'élément. String HTML, XUL
clientHeight La hauteur intérieure d'un élément. Number HTML
clientLeft L'épaisseur en pixels de la bordure gauche d'un élément. Number HTML
clientTop L'épaisseur en pixels de la bordure supérieure d'un élément. Number HTML
clientWidth La largeur intérieure d'un élément. Number HTML
dir Renvoie/définit le sens d'écriture d'un élément. String HTML, XUL
firstChild Le premier nœud enfant direct d'un élément, ou null si l'élément n'a pas de nœuds enfants. Node Toujours
id Définit ou obtient l'identifiant (id) de l'élément courant. String HTML, XUL
innerHTML Renvoie ou définit l'ensemble du balisage et du texte contenu au sein d'un élément donné. String HTML
lang Renvoie ou définit la langue des valeurs d'attribut, du texte et du contenu d'un élément. String HTML
lastChild Le dernier nœud enfant direct d'un élément, ou null si cet élément n'a pas de nœuds enfants. Node Toujours
localName La partie locale du nom qualifié d'un élément. String Toujours
Nom Description Type Disponibilité
name Définit ou obtient l'attribut name d'un élément. String HTML
namespaceURI L'URI de l'espace de noms d'un nœud, ou null si celui-ci n'est pas spécifié. String Toujours
nextSibling Le nœud suivant immédiatement celui donné dans l'arbre, ou null s'il n'y en a pas. Node Toujours
nodeName Le nom du nœud. String Toujours
nodeType Un nombre représentant le type du nœud. Celui-ci vaut toujours 1 pour les éléments DOM. Number Toujours
nodeValue La valeur du nœud. Celle-ci vaut toujours null pour les éléments DOM. String Toujours
offsetHeight La hauteur d'un élément tel qu'affiché. Number HTML
offsetLeft La distance entre le bord gauche d'un élément et le bord gauche de l'élément parent dans la mise en page (offsetParent). Number HTML
offsetParent L'élément par rapport auquel toutes les distances sont calculées. Element HTML
offsetTop La distance entre le bord supérieur d'un élément et le bord supérieur de l'élément parent dans la mise en page (offsetParent). Number HTML
offsetWidth La largeur d'un élément tel qu'affiché. Number HTML
ownerDocument Le document dans lequel un nœud apparait, ou null si le nœud n'est pas dans un document. Document Toujours
Nom Description Type Disponibilité
parentNode Le nœud parent d'un élément, ou null si le nœud n'est pas dans un document DOM. Node Toujours
prefix Le préfixe de l'espace de noms d'un nœud, ou null si celui-ci n'est pas spécifié. String Toujours
previousSibling Le nœud précédant immédiatement le nœud donné dans l'arbre, ou null s'il n'y en a pas. Node Toujours
scrollHeight La hauteur de la zone défilable d'un élément. Number HTML
scrollLeft Définit ou obtient le nombre de pixels duquel on fait défiler l'élément vers la gauche. Number HTML
scrollTop Définit ou obtient la distance entre le haut d'un élément et la portion supérieur de son contenu actuellement visible. Number HTML
scrollWidth La largeur de la zone défilable d'un élément. Number HTML
style Un objet représentant les déclarations de l'attribut style de l'élément. CSSStyle HTML, XUL
tabIndex Définit ou obtient la position de l'élément dans l'ordre de tabulation. Number HTML
tagName Le nom de la balise d'un élément donné. String Toujours
textContent Définit ou obtient le contenu textuel d'un élément et de ses descendants. String Toujours

Méthodes

addEventListener
Permet d'enregistrer des écouteurs d'évènement auprès d'une cible. (DOM Events)
appendChild
Insère le nœud spécifié au sein de la liste de nœuds du document courant. (DOM Core)
blur
Retire le focus clavier de l'élément courant. (HTML, XUL)
click
Simule un clic sur l'élément courant. (HTML, XUL)
cloneNode
Renvoie une copie du nœud courant. (DOM Core)
dispatchEvent
Permet la distribution d'évènements au sein du modèle évènementiel. (DOM Events)
focus
Positionne le focus sur l'élément courant. (HTML, XUL)
getAttribute
Renvoie la valeur de l'attribut spécifié pour le nœud courant. (DOM Core)
getAttributeNS
Renvoie la valeur de l'attribut pour le nom et l'espace de noms donnés.(DOM Core)
getAttributeNode
Renvoie l'attribut de l'élément sous la forme d'un nœud séparé. (DOM Core)
getAttributeNodeNS
Une version de getAttributeNode prenant en compte les espaces de noms. (DOM Core)
getElementsByTagName
Renvoie les éléments portant un nom particulier et faisant partie des descendants de l'élément courant. (DOM Core)
getElementsByTagNameNS
Renvoie les éléments portant un nom et un espace de noms particuliers faisant partie des descendants de l'élément courant. (DOM Core)
hasAttribute
Renvoie une valeur booléenne indiquant si l'élément courant possède ou non l'attribut spécifié. (DOM Core)
hasAttributeNS
Renvoie une valeur booléenne indiquant si l'élément courant possède ou non un attribut portant le nom donné dans l'espace de noms donné. (DOM Core)
hasAttributes
Renvoie une valeur booléenne indiquant si l'élément courant possède au moins un attribut. (DOM Core)
hasChildNodes
Renvoie une valeur booléenne indiquant si l'élément courant possède ou non des enfants. (DOM Core)
insertBefore
Insère un nœud avant l'élément courant dans l'arbre DOM. (DOM Core)
item
Retrouve un nœud dans une NodeList par son indice. (DOM Core, ne fait pas partie de l'interface Element)
normalize
Place le nœud courant et tous ses enfants sous une forme « normalisée ». (DOM Core)
removeAttribute
Retire un attribut de l'élément. (DOM Core)
removeAttributeNS
Retire l'attribut portant le nom spécifié dans l'espace de noms spécifié de l'élément. (DOM Core)
removeAttributeNode
Retire l'attribut spécifié de l'élément. (DOM Core)
removeChild
Retire un nœud enfant de l'élément courant. (DOM Core)
removeEventListener
Retire un écouteur d'évènements de l'élément. (DOM Core)
replaceChild
Remplace un nœud enfant de l'élément courant par un autre. (DOM Core)
scrollIntoView
Fait défiler la page jusqu'à ce que l'élément devienne visible. (HTML)
setAttribute
Ajoute un nouvel attribut ou modifie la valeur d'un attribut existant sur l'élément courant. (DOM Core)
setAttributeNS
Ajoute un nouvel attribut ou modifie la valeur d'un attribut existant dans l'espace de noms donné sur l'élément courant. (DOM Core)
setAttributeNode
Ajoute un nouveau nœud attribut à l'élément courant. (DOM Core)
setAttributeNodeNS
Ajoute un nouveau nœud attribut avec le nom et dans l'espace de noms spécifiés. (DOM Core)
supports
Teste si cette implémentation du DOM gère une fonctionnalité particulière. (DOM Core)

Évènements

Ce sont des propriétés qui correspondent aux attributs d'évènements HTML « on ».

Contrairement aux attributs correspondants, les valeurs de ces propriétés sont des fonctions (ou tout autre objet implémentant l'interface EventListener) plutôt que des chaînes de caractères. En fait, assigner un attribut d'évènement en HTML crée une fonction enveloppante autour du code spécifié. Par exemple, avec le code HTML suivant :

<div onclick="foo();">cliquez ici</div>

Si element est une référence vers cet élément div, la valeur de element.onclick sera :

function onclick(event) {
  foo();
}

Notez la façon dont l'objet event est passé comme paramètre event à cette fonction enveloppante.

onblur
Renvoie le code de gestion d'évènement pour l'évènement blur (perte de focus).
onchange
Renvoie le code de gestion d'évènement pour l'évènement change (modification).
onclick
Renvoie le code de gestion d'évènement pour l'évènement click (clic).
ondblclick
Renvoie le code de gestion d'évènement pour l'évènement dblclick (double clic).
onfocus
Renvoie le code de gestion d'évènement pour l'évènement focus (obtention du focus).
onkeydown
Renvoie le code de gestion d'évènement pour l'évènement keydown (touche enfoncée).
onkeypress
Renvoie le code de gestion d'évènement pour l'évènement keypress (touche pressée).
onkeyup
Renvoie le code de gestion d'évènement pour l'évènement keyup (touche relachée).
onmousedown
Renvoie le code de gestion d'évènement pour l'évènement mousedown (bouton de la souris enfoncé).
onmousemove
Renvoie le code de gestion d'évènement pour l'évènement mousemove (déplacement de la souris).
onmouseout
Renvoie le code de gestion d'évènement pour l'évènement mouseout (sortie du pointeur de la souris).
onmouseover
Renvoie le code de gestion d'évènement pour l'évènement mouseover (passage du pointeur de la souris par dessus l'élémént).
onmouseup
Renvoie le code de gestion d'évènement pour l'évènement mouseup (relachement du bouton de la souris).
onresize
Renvoie le code de gestion d'évènement pour l'évènement resize (redimensionnement).
onscroll
Renvoie le code de gestion d'évènement pour l'évènement scroll.
{{ wiki.languages( { "en": "en/DOM/element", "es": "es/DOM/element", "ja": "ja/DOM/element", "pl": "pl/DOM/element", "zh-cn": "cn/DOM/element" } ) }}

Source de la révision

<p>
{{template.DomRef()}}
</p><p>Ce chapitre fournit une brève référence des méthodes, propriétés et évènements généraux disponibles pour la plupart des éléments HTML et XML au sein du DOM des navigateurs utilisant Gecko.
</p><p>Plusieurs spécifications du W3C s'appliquent aux éléments DOM :
</p>
<ul><li> La <a class="external" href="http://www.w3.org/TR/DOM-Level-2-Core/">spécification DOM Core</a> (<a class="external" href="http://www.yoyodesign.org/doc/w3c/dom2-core/Overview.html">traduction</a>) — décrit les interfaces du noyau partagées par la plupart des objets DOM dans les documents HTML et XML
</li><li> La <a class="external" href="http://www.w3.org/TR/DOM-Level-2-HTML/">spécification DOM HTML</a> (<a class="external" href="http://www.yoyodesign.org/doc/w3c/dom2-html/Overview.html">traduction</a>) — décrit les interfaces pour les objets des documents HTML et XHTML construits sur base de la spécification DOM Core
</li><li> La <a class="external" href="http://www.w3.org/TR/DOM-Level-2-Events/">spécification DOM Events</a> (<a class="external" href="http://www.yoyodesign.org/doc/w3c/dom2-events/Overview.html">traduction</a>) — décrit les évènements partagés par la plupart des objets DOM, sur base des spécifications DOM Core et <a class="external" href="http://www.w3.org/TR/DOM-Level-2-Views/">Views</a> (<a class="external" href="http://www.yoyodesign.org/doc/w3c/dom2-views/Overview.html">traduction</a>).
</li></ul>
<p>Les articles listés ici couvrent ces différentes spécifications et fournissent des liens vers celles-ci aux endroits appropriés.
</p><p>Bien que ces interfaces soient généralement partagées par la plupart des éléments HTML et XML, il en existe d'autres, plus spécialisées, pour des objets particuliers listés dans la spécification DOM HTML — par exemple les interfaces de l'<a href="fr/DOM/table">élément HTML Table</a> et de l'<a href="fr/DOM/form">élément HTML Form</a>.
</p>
<h3 name="Propri.C3.A9t.C3.A9s"> Propriétés </h3>
<table class="fullwidth-table">
<tbody><tr>
<th>Nom</th>
<th>Description</th>
<th>Type</th>
<th>Disponibilité</th>
</tr>
<tr>
<td><code><a href="fr/DOM/element.attributes">attributes</a></code></td>
<td>Tous les attributs associés à un élément.</td>
<td><code><a href="fr/DOM/NamedNodeMap">NamedNodeMap</a></code></td>
<td nowrap="nowrap"><small><a href="fr/DOM">Toujours</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.childNodes">childNodes</a></code></td>
<td>Tous les nœuds enfants d'un élément.</td>
<td><code><a href="fr/DOM/NodeList">NodeList</a></code></td>
<td nowrap="nowrap"><small><a href="fr/DOM">Toujours</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.className">className</a></code></td>
<td>Définit ou obtient la classe de l'élément.</td>
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/String">String</a></code></td>
<td nowrap="nowrap"><small><a href="fr/HTML">HTML</a>, <a href="fr/XUL">XUL</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.clientHeight">clientHeight</a></code></td>
<td>La hauteur intérieure d'un élément.</td>
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/Number">Number</a></code></td>
<td nowrap="nowrap"><small><a href="fr/HTML">HTML</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.clientLeft">clientLeft</a></code></td>
<td>L'épaisseur en pixels de la bordure gauche d'un élément.</td>
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/Number">Number</a></code></td>
<td nowrap="nowrap"><small><a href="fr/HTML">HTML</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.clientTop">clientTop</a></code></td>
<td>L'épaisseur en pixels de la bordure supérieure d'un élément.</td>
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/Number">Number</a></code></td>
<td nowrap="nowrap"><small><a href="fr/HTML">HTML</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.clientWidth">clientWidth</a></code></td>
<td>La largeur intérieure d'un élément.</td>
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/Number">Number</a></code></td>
<td nowrap="nowrap"><small><a href="fr/HTML">HTML</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.dir">dir</a></code></td>
<td>Renvoie/définit le sens d'écriture d'un élément.</td>
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/String">String</a></code></td>
<td nowrap="nowrap"><small><a href="fr/HTML">HTML</a>, <a href="fr/XUL">XUL</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.firstChild">firstChild</a></code></td>
<td>Le premier nœud enfant direct d'un élément, ou <code>null</code> si l'élément n'a pas de nœuds enfants.</td>
<td><code><a href="fr/DOM/Node">Node</a></code></td>
<td nowrap="nowrap"><small><a href="fr/DOM">Toujours</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.id">id</a></code></td>
<td>Définit ou obtient l'identifiant (id) de l'élément courant.</td>
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/String">String</a></code></td>
<td nowrap="nowrap"><small><a href="fr/HTML">HTML</a>, <a href="fr/XUL">XUL</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.innerHTML">innerHTML</a></code></td>
<td>Renvoie ou définit l'ensemble du balisage et du texte contenu au sein d'un élément donné.</td>
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/String">String</a></code></td>
<td nowrap="nowrap"><small><a href="fr/HTML">HTML</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.lang">lang</a></code></td>
<td>Renvoie ou définit la langue des valeurs d'attribut, du texte et du contenu d'un élément.</td> 
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/String">String</a></code></td>
<td nowrap="nowrap"><small><a href="fr/HTML">HTML</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.lastChild">lastChild</a></code></td>
<td>Le dernier nœud enfant direct d'un élément, ou <code>null</code> si cet élément n'a pas de nœuds enfants.</td>
<td><code><a href="fr/DOM/Node">Node</a></code></td>
<td nowrap="nowrap"><small><a href="fr/DOM">Toujours</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.localName">localName</a></code></td>
<td>La partie locale du nom qualifié d'un élément.</td>
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/String">String</a></code></td>
<td nowrap="nowrap"><small><a href="fr/DOM">Toujours</a></small></td>
</tr>
<tr>
<th>Nom</th>
<th>Description</th>
<th>Type</th>
<th>Disponibilité</th>
</tr>
<tr>
<td><code><a href="fr/DOM/element.name">name</a></code></td>
<td>Définit ou obtient l'attribut <code>name</code> d'un élément.</td>
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/String">String</a></code></td>
<td nowrap="nowrap"><small><a href="fr/HTML">HTML</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.namespaceURI">namespaceURI</a></code></td>
<td>L'URI de l'espace de noms d'un nœud, ou <code>null</code> si celui-ci n'est pas spécifié.</td>
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/String">String</a></code></td>
<td nowrap="nowrap"><small><a href="fr/DOM">Toujours</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.nextSibling">nextSibling</a></code></td>
<td>Le nœud suivant immédiatement celui donné dans l'arbre, ou <code>null</code> s'il n'y en a pas.</td>
<td><code><a href="fr/DOM/Node">Node</a></code></td>
<td nowrap="nowrap"><small><a href="fr/DOM">Toujours</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.nodeName">nodeName</a></code></td>
<td>Le nom du nœud.</td>
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/String">String</a></code></td>
<td nowrap="nowrap"><small><a href="fr/DOM">Toujours</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.nodeType">nodeType</a></code></td>
<td>Un nombre représentant le type du nœud. Celui-ci vaut toujours <code>1</code> pour les éléments DOM.</td>
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/Number">Number</a></code></td>
<td nowrap="nowrap"><small><a href="fr/DOM">Toujours</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.nodeValue">nodeValue</a></code></td>
<td>La valeur du nœud. Celle-ci vaut toujours <code>null</code> pour les éléments DOM.</td>
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/String">String</a></code></td>
<td nowrap="nowrap"><small><a href="fr/DOM">Toujours</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.offsetHeight">offsetHeight</a></code></td>
<td>La hauteur d'un élément tel qu'affiché.</td>
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/Number">Number</a></code></td>
<td nowrap="nowrap"><small><a href="fr/HTML">HTML</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.offsetLeft">offsetLeft</a></code></td>
<td>La distance entre le bord gauche d'un élément et le bord gauche de l'élément parent dans la mise en page (<code>offsetParent</code>).</td>
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/Number">Number</a></code></td>
<td nowrap="nowrap"><small><a href="fr/HTML">HTML</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.offsetParent">offsetParent</a></code></td>
<td>L'élément par rapport auquel toutes les distances sont calculées.</td>
<td><code><a href="fr/DOM/element">Element</a></code></td>
<td nowrap="nowrap"><small><a href="fr/HTML">HTML</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.offsetTop">offsetTop</a></code></td>
<td>La distance entre le bord supérieur d'un élément et le bord supérieur de l'élément parent dans la mise en page (<code>offsetParent</code>).</td>
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/Number">Number</a></code></td>
<td nowrap="nowrap"><small><a href="fr/HTML">HTML</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.offsetWidth">offsetWidth</a></code></td>
<td>La largeur d'un élément tel qu'affiché.</td>
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/Number">Number</a></code></td>
<td nowrap="nowrap"><small><a href="fr/HTML">HTML</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.ownerDocument">ownerDocument</a></code></td>
<td>Le document dans lequel un nœud apparait, ou <code>null</code> si le nœud n'est pas dans un document.</td>
<td><code><a href="fr/DOM/document">Document</a></code></td>
<td nowrap="nowrap"><small><a href="fr/DOM">Toujours</a></small></td>
</tr>
<tr>
<th>Nom</th>
<th>Description</th>
<th>Type</th>
<th>Disponibilité</th>
</tr>
<tr>
<td><code><a href="fr/DOM/element.parentNode">parentNode</a></code></td>
<td>Le nœud parent d'un élément, ou <code>null</code> si le nœud n'est pas dans un <a href="fr/DOM/document">document DOM</a>.</td>
<td><code><a href="fr/DOM/Node">Node</a></code></td>
<td nowrap="nowrap"><small><a href="fr/DOM">Toujours</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.prefix">prefix</a></code></td>
<td>Le préfixe de l'espace de noms d'un nœud, ou <code>null</code> si celui-ci n'est pas spécifié.</td>
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/String">String</a></code></td>
<td nowrap="nowrap"><small><a href="fr/DOM">Toujours</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.previousSibling">previousSibling</a></code></td>
<td>Le nœud précédant immédiatement le nœud donné dans l'arbre, ou <code>null</code> s'il n'y en a pas.</td>
<td><code><a href="fr/DOM/Node">Node</a></code></td>
<td nowrap="nowrap"><small><a href="fr/DOM">Toujours</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.scrollHeight">scrollHeight</a></code></td>
<td>La hauteur de la zone défilable d'un élément.</td>
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/Number">Number</a></code></td>
<td nowrap="nowrap"><small><a href="fr/HTML">HTML</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.scrollLeft">scrollLeft</a></code></td>
<td>Définit ou obtient le nombre de pixels duquel on fait défiler l'élément vers la gauche.</td>
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/Number">Number</a></code></td>
<td nowrap="nowrap"><small><a href="fr/HTML">HTML</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.scrollTop">scrollTop</a></code></td>
<td>Définit ou obtient la distance entre le haut d'un élément et la portion supérieur de son contenu actuellement visible.</td>
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/Number">Number</a></code></td>
<td nowrap="nowrap"><small><a href="fr/HTML">HTML</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.scrollWidth">scrollWidth</a></code></td>
<td>La largeur de la zone défilable d'un élément.</td>
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/Number">Number</a></code></td>
<td nowrap="nowrap"><small><a href="fr/HTML">HTML</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.style">style</a></code></td>
<td>Un objet représentant les déclarations de l'attribut <code>style</code> de l'élément.</td>
<td><code><a href="fr/DOM/CSSStyleDeclaration">CSSStyle</a></code></td>
<td nowrap="nowrap"><small><a href="fr/HTML">HTML</a>, <a href="fr/XUL">XUL</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.tabIndex">tabIndex</a></code></td>
<td>Définit ou obtient la position de l'élément dans l'ordre de tabulation.</td>
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/Number">Number</a></code></td>
<td nowrap="nowrap"><small><a href="fr/HTML">HTML</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.tagName">tagName</a></code></td>
<td>Le nom de la balise d'un élément donné.</td>
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/String">String</a></code></td>
<td nowrap="nowrap"><small><a href="fr/DOM">Toujours</a></small></td>
</tr>
<tr>
<td><code><a href="fr/DOM/element.textContent">textContent</a></code></td>
<td>Définit ou obtient le contenu textuel d'un élément et de ses descendants.</td>
<td><code><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/String">String</a></code></td>
<td nowrap="nowrap"><small><a href="fr/DOM">Toujours</a></small></td>
</tr>
</tbody></table>
<h3 name="M.C3.A9thodes"> Méthodes </h3>
<dl><dt> <a href="fr/DOM/element.addEventListener">addEventListener</a>
</dt><dd> Permet d'enregistrer des écouteurs d'évènement auprès d'une cible. (DOM Events)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.appendChild">appendChild</a>
</dt><dd> Insère le nœud spécifié au sein de la liste de nœuds du document courant. (DOM Core)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.blur">blur</a>
</dt><dd> Retire le focus clavier de l'élément courant. (HTML, XUL)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.click">click</a>
</dt><dd> Simule un clic sur l'élément courant. (HTML, XUL)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.cloneNode">cloneNode</a>
</dt><dd> Renvoie une copie du nœud courant. (DOM Core)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.dispatchEvent">dispatchEvent</a>
</dt><dd> Permet la distribution d'évènements au sein du modèle évènementiel. (DOM Events)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.focus">focus</a>
</dt><dd> Positionne le focus sur l'élément courant. (HTML, XUL)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.getAttribute">getAttribute</a>
</dt><dd> Renvoie la valeur de l'attribut spécifié pour le nœud courant. (DOM Core)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.getAttributeNS">getAttributeNS</a>
</dt><dd> Renvoie la valeur de l'attribut pour le nom et l'espace de noms donnés.(DOM Core)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.getAttributeNode">getAttributeNode</a>
</dt><dd> Renvoie l'attribut de l'élément sous la forme d'un nœud séparé. (DOM Core)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.getAttributeNodeNS">getAttributeNodeNS</a>
</dt><dd> Une version de <code>getAttributeNode</code> prenant en compte les espaces de noms. (DOM Core)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.getElementsByTagName">getElementsByTagName</a>
</dt><dd> Renvoie les éléments portant un nom particulier et faisant partie des descendants de l'élément courant. (DOM Core)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.getElementsByTagNameNS">getElementsByTagNameNS</a>
</dt><dd> Renvoie les éléments portant un nom et un espace de noms particuliers faisant partie des descendants de l'élément courant. (DOM Core)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.hasAttribute">hasAttribute</a>
</dt><dd> Renvoie une valeur booléenne indiquant si l'élément courant possède ou non l'attribut spécifié. (DOM Core)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.hasAttributeNS">hasAttributeNS</a>
</dt><dd> Renvoie une valeur booléenne indiquant si l'élément courant possède ou non un attribut portant le nom donné dans l'espace de noms donné. (DOM Core)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.hasAttributes">hasAttributes</a>
</dt><dd> Renvoie une valeur booléenne indiquant si l'élément courant possède au moins un attribut. (DOM Core)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.hasChildNodes">hasChildNodes</a>
</dt><dd> Renvoie une valeur booléenne indiquant si l'élément courant possède ou non des enfants. (DOM Core)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.insertBefore">insertBefore</a>
</dt><dd> Insère un nœud avant l'élément courant dans l'arbre DOM. (DOM Core)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.item">item</a>
</dt><dd> Retrouve un nœud dans une <code>NodeList</code> par son indice. (DOM Core, ne fait pas partie de l'interface <code>Element</code>)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.normalize">normalize</a>
</dt><dd> Place le nœud courant et tous ses enfants sous une forme « normalisée ». (DOM Core)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.removeAttribute">removeAttribute</a>
</dt><dd> Retire un attribut de l'élément. (DOM Core)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.removeAttributeNS">removeAttributeNS</a>
</dt><dd> Retire l'attribut portant le nom spécifié dans l'espace de noms spécifié de l'élément. (DOM Core)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.removeAttributeNode">removeAttributeNode</a>
</dt><dd> Retire l'attribut spécifié de l'élément. (DOM Core)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.removeChild">removeChild</a>
</dt><dd> Retire un nœud enfant de l'élément courant. (DOM Core)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.removeEventListener">removeEventListener</a>
</dt><dd> Retire un écouteur d'évènements de l'élément. (DOM Core)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.replaceChild">replaceChild</a>
</dt><dd> Remplace un nœud enfant de l'élément courant par un autre. (DOM Core)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.scrollIntoView">scrollIntoView</a>
</dt><dd> Fait défiler la page jusqu'à ce que l'élément devienne visible. (HTML)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.setAttribute">setAttribute</a>
</dt><dd> Ajoute un nouvel attribut ou modifie la valeur d'un attribut existant sur l'élément courant. (DOM Core)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.setAttributeNS">setAttributeNS</a>
</dt><dd> Ajoute un nouvel attribut ou modifie la valeur d'un attribut existant dans l'espace de noms donné sur l'élément courant. (DOM Core)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.setAttributeNode">setAttributeNode</a>
</dt><dd> Ajoute un nouveau nœud attribut à l'élément courant. (DOM Core)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.setAttributeNodeNS">setAttributeNodeNS</a>
</dt><dd> Ajoute un nouveau nœud attribut avec le nom et dans l'espace de noms spécifiés. (DOM Core)
</dd></dl>
<dl><dt> <a href="fr/DOM/element.supports">supports</a>
</dt><dd> Teste si cette implémentation du DOM gère une fonctionnalité particulière. (DOM Core)
</dd></dl>
<h3 name=".C3.89v.C3.A8nements"> Évènements </h3>
<p>Ce sont des propriétés qui correspondent aux attributs d'évènements HTML « <code>on</code> ».
</p><p>Contrairement aux attributs correspondants, les valeurs de ces propriétés sont des fonctions (ou tout autre objet implémentant l'interface <a class="external" href="http://www.w3.org/TR/DOM-Level-2-Events/events.html#Events-EventListener">EventListener</a>) plutôt que des chaînes de caractères. En fait, assigner un attribut d'évènement en HTML crée une fonction enveloppante autour du code spécifié. Par exemple, avec le code HTML suivant :
</p>
<pre>&lt;div onclick="foo();"&gt;cliquez ici&lt;/div&gt;
</pre>
<p>Si <code>element</code> est une référence vers cet élément <code>div</code>, la valeur de <code>element.onclick</code> sera :
</p>
<pre>function onclick(event) {
  foo();
}
</pre>
<p>Notez la façon dont l'objet <a href="fr/DOM/event">event</a> est passé comme paramètre <code>event</code> à cette fonction enveloppante.
</p>
<dl><dt> <a href="fr/DOM/element.onblur">onblur</a>
</dt><dd> Renvoie le code de gestion d'évènement pour l'évènement <code>blur</code> (perte de focus).
</dd></dl>
<dl><dt> <a href="fr/DOM/element.onchange">onchange</a>
</dt><dd> Renvoie le code de gestion d'évènement pour l'évènement <code>change</code> (modification).
</dd></dl>
<dl><dt> <a href="fr/DOM/element.onclick">onclick</a>
</dt><dd> Renvoie le code de gestion d'évènement pour l'évènement <code>click</code> (clic).
</dd></dl>
<dl><dt> <a href="fr/DOM/element.ondblclick">ondblclick</a>
</dt><dd> Renvoie le code de gestion d'évènement pour l'évènement <code>dblclick</code> (double clic).
</dd></dl>
<dl><dt> <a href="fr/DOM/element.onfocus">onfocus</a>
</dt><dd> Renvoie le code de gestion d'évènement pour l'évènement <code>focus</code> (obtention du focus).
</dd></dl>
<dl><dt> <a href="fr/DOM/element.onkeydown">onkeydown</a>
</dt><dd> Renvoie le code de gestion d'évènement pour l'évènement <code>keydown</code> (touche enfoncée).
</dd></dl>
<dl><dt> <a href="fr/DOM/element.onkeypress">onkeypress</a>
</dt><dd> Renvoie le code de gestion d'évènement pour l'évènement <code>keypress</code> (touche pressée).
</dd></dl>
<dl><dt> <a href="fr/DOM/element.onkeyup">onkeyup</a>
</dt><dd> Renvoie le code de gestion d'évènement pour l'évènement <code>keyup</code> (touche relachée).
</dd></dl>
<dl><dt> <a href="fr/DOM/element.onmousedown">onmousedown</a>
</dt><dd> Renvoie le code de gestion d'évènement pour l'évènement <code>mousedown</code> (bouton de la souris enfoncé).
</dd></dl>
<dl><dt> <a href="fr/DOM/element.onmousemove">onmousemove</a>
</dt><dd> Renvoie le code de gestion d'évènement pour l'évènement <code>mousemove</code> (déplacement de la souris).
</dd></dl>
<dl><dt> <a href="fr/DOM/element.onmouseout">onmouseout</a>
</dt><dd> Renvoie le code de gestion d'évènement pour l'évènement <code>mouseout</code> (sortie du pointeur de la souris).
</dd></dl>
<dl><dt> <a href="fr/DOM/element.onmouseover">onmouseover</a>
</dt><dd> Renvoie le code de gestion d'évènement pour l'évènement <code>mouseover</code> (passage du pointeur de la souris par dessus l'élémént).
</dd></dl>
<dl><dt> <a href="fr/DOM/element.onmouseup">onmouseup</a>
</dt><dd> Renvoie le code de gestion d'évènement pour l'évènement <code>mouseup</code> (relachement du bouton de la souris).
</dd></dl>
<dl><dt> <a href="fr/DOM/element.onresize">onresize</a>
</dt><dd> Renvoie le code de gestion d'évènement pour l'évènement <code>resize</code> (redimensionnement).
</dd></dl>
<dl><dt> <a href="fr/DOM/element.onscroll">onscroll</a>
</dt><dd> Renvoie le code de gestion d'évènement pour l'évènement <code>scroll</code>.
</dd></dl>
<div class="noinclude">
</div>
{{ wiki.languages( { "en": "en/DOM/element", "es": "es/DOM/element", "ja": "ja/DOM/element", "pl": "pl/DOM/element", "zh-cn": "cn/DOM/element" } ) }}
Revenir à cette révision