HTMLElement

Baseline Widely available *

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨juillet 2015⁩.

* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.

L'interface HTMLElement représente n'importe quel élément HTML. Certains éléments implémentent directement cette interface tandis que d'autres implémentent une interface qui hérite de celle-ci.

Propriétés

Hérite des propriétés de son parent, Element, et implémente celles du mixin GlobalEventHandlers.

HTMLElement.accessKey: Une chaîne de caractères qui représente la touche d'accès affecté à l'élément.
HTMLElement.accessKeyLabel Lecture seule: Renvoie une chaîne de caractères contenant la touche d'accès affectée à l'élément.
HTMLElement.attributeStyleMap Lecture seule: Un objet StylePropertyMap qui représente les déclarations contenues dans l'attribut style de l'élément.
HTMLElement.contentEditable: Une chaîne de caractères qui, si elle vaut true indique que l'élément est éditable et qui, si elle vaut false indique que l'élément n'est pas éditable.
HTMLElement.isContentEditable Lecture seule: Renvoie une valeur booléenne indiquant si le contenu de l'élément peut être édité.
HTMLElement.contextMenu Obsolète: Un objet HTMLMenuElement qui représente le menu contextuel associé à l'élément. Il peut valoir null.
HTMLElement.dataset Lecture seule: Renvoie un objet DOMStringMap avec lequel il est possible de lire et d'écrire les attributs de données spécifiques (data-*).
HTMLElement.dir: Une chaîne de caractères reflétant l'attribut universel dir et qui représente le sens d'écriture de l'élément. Les valeurs possibles sont "ltr" (gauche à droite), "rtl" (droite à gauche), et "auto".
HTMLElement.draggable: Une valeur booléenne indiquant si l'élément peut être déplacé.
HTMLElement.enterkeyhint: Une chaîne de caractères qui définit le libellé (ou l'icône) à présenter comme libellé d'action pour la touche Entrée des claviers virtuels.
HTMLElement.hidden: Une valeur booléenne indiquant si l'élément est caché.
HTMLElement.inert: Une valeur booléenne indiquant si l'agent utilisateur doit agir comme si le nœud donné était absent en ce qui concerne les évènements d'interaction, les recherches de texte dans la page, et la sélection de texte.
HTMLElement.innerText: Représente le contenu du texte rendu d'un nœud et de ses descendants. Comme accesseur, il approxime le texte qu'une personne aurait en surlignant le contenu de l'élément avec le curseur et en copiant ceci dans un presse-papier. Comme mutateur, il remplace le contenu à l'intérieur de l'élément sélectionné, convertissant tout saut de ligne en élément <br>.
HTMLElement.lang: Une chaîne de caractères représentant la langue du contenu, du texte et des attributs d'un élément.
HTMLElement.noModule: Une valeur booléenne indiquant si un script d'import peut être exécuté par les agents utilisateur qui prennent en charge les modules de script.
HTMLElement.nonce: Renvoie le nonce cryptographique utilisé par la politique de sécurité du contenu afin de déterminer si le traitement d'une récupération de ressource est autorisé.
HTMLElement.offsetHeight Lecture seule: Renvoie une valeur numérique double contenant la hauteur de l'élément, relativement à la disposition.
HTMLElement.offsetLeft Lecture seule: Renvoie une valeur numérique double indiquant la distance entre la bordure gauche de cet élément et la bordure gauche de son élément offsetParent.
HTMLElement.offsetParent Lecture seule: Un objet Element représentant l'élément de référence par rapport auquel tous les calculs de décalage sont effectués.
HTMLElement.offsetTop Lecture seule: Renvoie une valeur numérique double, indiquant la distance entre la bordure haute de cet élément et la bordure haute de son élément offsetParent.
HTMLElement.offsetWidth Lecture seule: Renvoie une valeur numérique double contenant la largeur de l'élément, relativement à la disposition.
HTMLElement.outerText: Représente le texte rendu du contenu d'un nœud et de ses descendants. Comme accesseur, il se comporte comme HTMLElement.innerText (il représente le contenu texte d'un élément et de ses descendants). Comme mutateur, il remplace le nœud sélectionné et son contenu avec la valeur fournie, convertissant au passage tout saut de ligne en éléments <br>.
HTMLElement.properties Expérimental Lecture seule: Renvoi un objet HTMLPropertiesCollection.
HTMLElement.spellcheck: Une valeur booléenne reflétant l'attribut HTML spellcheck. Cette propriété est présente sur tous les éléments HTML même si elle n'a pas d'effet pour tous.
HTMLElement.style: Un objet CSSStyleDeclaration qui représente les déclarations contenues dans l'attribut style de l'élément.
HTMLElement.tabIndex: Une valeur numérique long représentant la position de l'élément dans l'ordre de tabulation.
HTMLElement.title: Une chaîne de caractères contenant le texte apparaissant dans la bulle d'information affichée lorsque la souris survole l'élément.
HTMLElement.translate Expérimental: Une valeur booléenne représentant la traduction.

La plupart des propriétés pour la gestion d'évènements, de la forme onXYZ, sont définies par l'interface GlobalEventHandlers et implémentées par HTMLElement. Voici les gestionnaires d'évènements spécifiques à HTMLElement.

TouchEventHandlers.ontouchstart Non standard: Renvoie le code de gestion d'évènement pour l'évènement touchstart.
TouchEventHandlers.ontouchend Non standard: Renvoie le code de gestion d'évènement pour l'évènement touchend.
TouchEventHandlers.ontouchmove Non standard: Renvoie le code de gestion d'évènement pour l'évènement touchmove.
TouchEventHandlers.ontouchcancel Non standard: Renvoie le code de gestion d'évènement pour l'évènement touchcancel.

Méthodes

Hérite des méthodes de son parent, Element, et implémente celles du mixin GlobalEventHandlers.

HTMLElement.attachInternals() Expérimental: Renvoie un objet ElementInternals et active la participation d'un élément personnalisé aux formulaires HTML.
HTMLElement.blur(): Retire le focus clavier de l'élément qui a le focus.
HTMLElement.click(): Envoie un évènement de clic de souris à l'élément.
HTMLElement.focus(): Passe le focus clavier à l'élément courant.

Évènements

On écoutera ces évènements à l'aide de addEventListener() ou en affectant un gestionnaire d'évènement à la propriété onnomevenement de cette interface.

copy: Déclenché lorsque l'utilisatrice ou l'utilisateur initie une action de copier via l'interface du navigateur.
cut: Déclenché lorsque l'utilisatrice ou l'utilisateur initie une action de couper via l'interface du navigateur.
paste: Déclenché lorsque l'utilisatrice ou l'utilisateur initie une action de coller via l'interface du navigateur.
invalid: Déclenché lorsqu'un élément ne respecte pas les contraintes pendant la validation de contrainte. Également disponible via la propriété onvalid.

Évènements relatifs aux animations

animationcancel: Déclenché lorsqu'une animation se termine de manière inattendue. Également disponible via la propriété onanimationcancel.
animationend: Déclenché lorsqu'une animation se termine normalement. Également disponible via la propriété onanimationend.
animationiteration: Déclenché lorsqu'une itération d'une animation est terminée. Également disponible via la propriété onanimationiteration.
animationstart: Déclenché lorsqu'une animation démarre. Également disponible via la propriété onanimationstart.

Évènements de saisie

beforeinput: Déclenché lorsque la valeur d'un élément <input>, <select>, ou <textarea> est sur le point d'être modifiée.
input: Déclenché lorsque la valeur d'un élément <input>, <select>, ou <textarea> a été modifiée. Également disponible via la propriété oninput.
change: Déclenché lorsque la valeur d'un élément <input>, <select>, ou <textarea> a été modifiée et validée par l'utilisatrice ou l'utilisateur. À la différence de l'évènement input, l'évènement change n'est pas nécessairement déclenché pour chaque altération de la valeur de l'élément.

Évènements de pointeur

gotpointercapture: Déclenché lorsqu'un élément capture un pointeur à l'aide de setPointerCapture(). Également disponible via la propriété ongotpointercapture.
lostpointercapture: Déclenché lorsqu'un pointeur capturé est relâché. Également disponible via la propriété onlostpointercapture.
pointercancel: Déclenché lorsqu'un évènement de pointeur est annulé. Également disponible via la propriété onpointercancel.
pointerdown: Déclenché lorsqu'un pointeur devient actif. Également disponible via la propriété onpointerdown.
pointerenter: Déclenché lorsqu'un pointeur est déplacé dans la zone de contact d'un élément ou d'un de ses descendants. Également disponible via la propriété onpointerenter.
pointerleave: Déclenché lorsqu'un pointeur est déplacé en dehors de la zone de contact d'un élément. Également disponible via la propriété onpointerleave.
pointermove: Déclenché lorsqu'un pointeur change de coordonnées. Également disponible via la propriété onpointermove.
pointerout: Déclenché lorsqu'un pointeur est déplacé en dehors de la zone de contact d'un élément (entre autres). Également disponible via la propriété onpointerout.
pointerover: Déclenché lorsqu'un pointeur est déplacé à l'intérieur de la zone de contact d'un élément. Également disponible via la propriété onpointerover.
pointerup: Déclenché lorsqu'un pointeur n'est plus actif. Également disponible via la propriété onpointerup.

Évènements de transition

transitioncancel: Déclenché lorsqu'une transition CSS est annulée. Également disponible via la propriété ontransitioncancel.
transitionend: Déclenché lorsqu'une transition CSS est terminée. Également disponible via la propriété ontransitionend.
transitionrun: Déclenché lorsqu'une transition CSS est initialement créée. Également disponible via la propriété ontransitionrun.
transitionstart: Déclenché lorsqu'une transition CSS a effectivement démarré. Également disponible via la propriété ontransitionstart.

Spécifications

Specification
HTML # htmlelement

Compatibilité des navigateurs

Voir aussi

Element

Help improve MDN

Learn how to contribute

Cette page a été modifiée le ⁨7 sept. 2025⁩ par les contributeurs du MDN.

View this page on GitHub • Report a problem with this content