HTMLElement

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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.

EventTarget Node Element HTMLElement

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.

Gestionnaires d'évènements

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 Standard
# htmlelement

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi