Objet HTMLElement XML DOM

L'objet HTMLElement représente un élément dans HTML.

Les propriétés de l'objet HTMLElement

Chaque élément d'un document HTML a une propriété correspondant à l'attribut HTML de l'élément. Voici une liste de toutes les propriétés supportées par tous les balises HTML. D'autres propriétés sont spécifiques à un type d'élément HTML spécifique. L'objet HTMLElement hérite de Node et Element Les attributs standard de l'objet, qui implémentent également les attributs non standard décrits ci-dessous:

className

Définit l'attribut class de l'élément. Notez que le nom de cet attribut n'est pas "class", car "class" est un mot réservé en JavaScript.

Type : chaîne. État : modifiable.

currentStyle

Cet attribut spécifique à IE s'applique à tous les groupes de propriétés CSS de l'élément. Il est un substitut de Window.getComputedStyle() spécifique à IE.

Type : chaîne. État : modifiable.

dir

Définit l'attribut dir de l'élément, qui déclare la direction du texte du document.

Type : chaîne. État : modifiable.

id

Définit l'attribut id de l'élément. Dans un document, aucun élément ne possède le même attribut id.

Type : chaîne. État : modifiable.

innerHTML

Définit la chaîne de caractères contenue par l'élément, sans inclure les balises de début et de fin de l'élément lui-même. La recherche de cet attribut renverra le contenu de l'élément sous forme de chaîne de texte HTML. En définissant cet attribut comme une chaîne de texte HTML, vous pouvez remplacer le contenu de l'élément avec des balises de représentation HTML. Vous ne pouvez pas définir cet attribut au moment du chargement du document. C'est un attribut non standard dérivé de IE4, mais il est maintenant supporté par tous les navigateurs modernes.

Type : chaîne. État : modifiable.

lang

Définit l'attribut lang de l'élément, qui déclare le code de langue du contenu de l'élément.

Type : chaîne. État : modifiable.

offsetHeight, offsetWidth

Retourne la hauteur et la largeur de l'élément, en pixels. C'est une propriété non standard mais bien supportée.

Type : int. État : lecture seule.

offsetLeft

Retourne l'offset de la bordure gauche de l'élément actuel à la bordure gauche de son élément conteneur, en pixels.

Type : int. État : lecture seule.

offsetTop

Retourne l'offset de la bordure supérieure de l'élément actuel à la bordure supérieure de son élément conteneur, en pixels.

Type : int. État : lecture seule.

offsetParent

Retourne une référence à l'élément de positionnement dynamique le plus proche, toutes les offsets sont déterminés par cet élément. Si l'attribut style.display de l'élément est défini sur none, cette propriété retourne null. C'est une propriété non standard mais bien supportée.

Type :Node. État : lecture seule.

scrollHeight, scrollWidth

Retourne la hauteur et la largeur complètes de l'élément, en pixels. Lorsqu'un élément a une barre de défilement (par exemple, en raison de l'attribut CSS overflow), ces propriétés sont différentes de offsetHeight et offsetWidth, offsetHeight et offsetWidth ne signalent que la taille visible de l'élément. C'est une propriété non standard mais bien supportée.

Type : int. État : lecture seule.

scrollTop, scrollLeft

Définit ou retourne le nombre de pixels de défilement à la bordure gauche ou supérieure de l'élément. Ces pixels ne sont utiles que lorsque l'élément a une barre de défilement, par exemple, lorsque l'attribut CSS overflow de l'élément est défini sur auto. Ces propriétés ne sont définies que sur les balises <body> ou <html> du document (cela dépend du navigateur) et ensemble, elles déterminent la position de défilement du document. Notez que ces propriétés ne spécifient pas la quantité de défilement d'une balise <iframe>. C'est une propriété non standard mais bien supportée.

Type : int. État : modifiable.

style

Retourne la valeur de l'attribut style CSS en ligne définie pour l'élément courant. Notez que la valeur de cet attribut n'est pas une chaîne de caractères.

Type :CSS2Properties. État : lecture seule.

title

Définit l'attribut title de l'élément. Lorsque la souris est placée sur l'élément, de nombreux navigateurs affichent la valeur de cet attribut dans le "tool tip" de l'élément.

Type : chaîne. État : modifiable.

Les méthodes de l'objet HTMLElement

L'objet HTMLElement hérite de Node et Element Les méthodes standard de l'objet. Certains types d'éléments implémentent des méthodes spécifiques au balisage, CodeW3C.com sur Manuel de référence HTML DOMLes pages de référence des différents balises fournissent des informations sur ces méthodes.

La plupart des navigateurs modernes ont également mis en œuvre les méthodes non standard suivantes :

Méthode Description
scrollIntoView() Faites défiler le document. Faites apparaître cet élément en haut ou en bas de la fenêtre.

Gestionnaires d'événements de l'objet HTMLElement

Tous les éléments HTML qui réagissent aux événements de souris et de clavier peuvent déclencher les gestionnaires d'événements listés ici. Certains éléments, tels que les liens et les boutons, exécutent des opérations par défaut lorsque ces événements se produisent. Pour ces éléments, plus de détails peuvent être trouvés dansPage de référence de l'élément spécifiquetrouvé.

Voir Manuel de référence des attributs d'événement HTMLPour en savoir plus sur les gestionnaires d'événements HTML.

Comment obtenir des informations plus détaillées sur l'objet HTMLElement

Dans le manuel de référence HTML DOM de CodeW3C.com, nous avons créé des pages de référence spéciales pour les objets DOM correspondant aux balises HTML :

Manuel de référence HTML DOM

Pages connexes

Manuel de référence DOM XML :Objet Document

Manuel de référence DOM XML :getElementById() Document

Manuel de référence DOM XML :getElementsByTagName() Document