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'interfaceHTMLElement représente n'importe quel élémentHTML. 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 mixinGlobalEventHandlers.

HTMLElement.accessKey: Une chaîne de caractères qui représente la touche d'accès affecté à l'élément.
HTMLElement.accessKeyLabelLecture seule: Renvoie une chaîne de caractères contenant la touche d'accès affectée à l'élément.
HTMLElement.attributeStyleMapLecture seule: Un objetStylePropertyMap qui représente les déclarations contenues dans l'attributstyle de l'élément.
HTMLElement.contentEditable: Une chaîne de caractères qui, si elle vauttrue indique que l'élément est éditable et qui, si elle vautfalse indique que l'élément n'est pas éditable.
HTMLElement.isContentEditableLecture seule: Renvoie une valeur booléenne indiquant si le contenu de l'élément peut être édité.
HTMLElement.contextMenuObsolète: Un objet HTMLMenuElement qui représente le menu contextuel associé à l'élément. Il peut valoirnull.
HTMLElement.datasetLecture seule: Renvoie un objetDOMStringMap avec lequel il est possible de lire et d'écrireles attributs de données spécifiques (data-*).
HTMLElement.dir: Une chaîne de caractères reflétant l'attribut universeldir 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 toucheEntré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.offsetHeightLecture seule: Renvoie une valeur numériquedouble contenant la hauteur de l'élément, relativement à la disposition.
HTMLElement.offsetLeftLecture seule: Renvoie une valeur numériquedouble indiquant la distance entre la bordure gauche de cet élément et la bordure gauche de son élémentoffsetParent.
HTMLElement.offsetParentLecture seule: Un objetElement représentant l'élément de référence par rapport auquel tous les calculs de décalage sont effectués.
HTMLElement.offsetTopLecture seule: Renvoie une valeur numériquedouble, indiquant la distance entre la bordure haute de cet élément et la bordure haute de son élémentoffsetParent.
HTMLElement.offsetWidthLecture seule: Renvoie une valeur numériquedouble 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 commeHTMLElement.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.propertiesExpérimentalLecture seule: Renvoi un objet HTMLPropertiesCollection.
HTMLElement.spellcheck: Une valeur booléenne reflétant l'attribut HTMLspellcheck. 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 objetCSSStyleDeclaration qui représente les déclarations contenues dans l'attributstyle de l'élément.
HTMLElement.tabIndex: Une valeur numériquelong 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.translateExpérimental: Une valeur booléenne représentant la traduction.

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

TouchEventHandlers.ontouchstartNon standard: Renvoie le code de gestion d'évènement pour l'évènement touchstart.
TouchEventHandlers.ontouchendNon standard: Renvoie le code de gestion d'évènement pour l'évènement touchend.
TouchEventHandlers.ontouchmoveNon standard: Renvoie le code de gestion d'évènement pour l'évènement touchmove.
TouchEventHandlers.ontouchcancelNon 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 mixinGlobalEventHandlers.

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 deaddEventListener() 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ènementinput, l'évènementchange 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 desetPointerCapture(). Également disponible via la propriétéongotpointercapture.
lostpointercapture: Déclenché lorsqu'unpointeur 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'unetransition CSS est annulée. Également disponible via la propriétéontransitioncancel.
transitionend: Déclenché lorsqu'unetransition CSS est terminée. Également disponible via la propriétéontransitionend.
transitionrun: Déclenché lorsqu'unetransition CSS est initialement créée. Également disponible via la propriétéontransitionrun.
transitionstart: Déclenché lorsqu'unetransition CSS a effectivement démarré. Également disponible via la propriétéontransitionstart.