HTMLElement

Propriétés d'instance

Hérite également des propriétés de son parent, Element.

HTMLElement.accessKey

Une chaîne de caractères qui représente la touche d'accès affecté à l'élément.

HTMLElement.accessKeyLabel Lecture seule

Retourne une chaîne de caractères contenant la touche d'accès affectée à l'élément.

HTMLElement.anchorElement Lecture seule Non standard Expérimental

Retourne une référence à l'élément d'ancrage de l'élément, ou null s'il n'en a pas.

HTMLElement.attributeStyleMap Lecture seule

Un objet StylePropertyMap qui représente les déclarations contenues dans l'attribut style de l'élément.

HTMLElement.autocapitalize

Une chaîne de caractères qui représente le comportement de capitalisation de l'élément pour la saisie de l'utilisateur·ice. Les valeurs valides sont : none, off, on, characters, words, sentences.

HTMLElement.autofocus

Un booléen reflétant l'attribut HTML universel autofocus, qui indique si le contrôle doit être sélectionné lors du chargement de la page, ou lorsque la boîte de dialogue ou la fenêtre contextuelle (popover en anglais) devient visible si défini dans un élément à l'intérieur d'éléments HTML <dialog> ou d'éléments dont l'attribut popover est défini.

HTMLElement.autocorrect

Un booléen qui représente si le texte saisi par l'utilisateur·ice doit être automatiquement corrigé. Cela reflète l'attribut HTML universel autocorrect.

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.dataset Lecture seule

Retourne 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

Un booléen indiquant si l'élément peut être déplacé.

HTMLElement.editContext Expérimental

Retourne l'objet EditContext associé à l'élément, ou null s'il n'y en a pas.

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 chaîne de caractères ou un booléen reflétant la valeur de l'attribut hidden de l'élément.

HTMLElement.inert

Un booléen indiquant si l'agent utilisateur doit agir comme si le nœud donné était absent pour les évènements d'interaction, les recherches de texte dans la page (« rechercher dans la page ») et la sélection de texte.

HTMLElement.innerText

Représente le contenu texte rendu d'un nœud et de ses descendants. Comme accesseur, il approxime le texte qu'une personne obtiendrait en surlignant le contenu de l'élément avec le curseur puis en le copiant dans le presse-papier. Comme mutateur, il remplace le contenu à l'intérieur de l'élément sélectionné, convertissant tout saut de ligne en éléments HTML <br>.

HTMLElement.inputMode

Une chaîne de caractères reflétant la valeur de l'attribut inputmode de l'élément.

HTMLElement.isContentEditable Lecture seule

Retourne un booléen indiquant si le contenu de l'élément peut être édité.

HTMLElement.lang

Une chaîne de caractères représentant la langue du contenu, du texte et des attributs d'un élément.

HTMLElement.nonce

Retourne le nombre cryptographique à usage unique utilisé par la politique de sécurité du contenu pour déterminer si une récupération de ressource donnée est autorisée.

HTMLElement.offsetHeight Lecture seule

Retourne une valeur numérique double contenant la hauteur de l'élément, relativement à la disposition.

HTMLElement.offsetLeft Lecture seule

Retourne 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

Retourne 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

Retourne une valeur numérique double contenant la largeur de l'élément, relativement à la disposition.

HTMLElement.outerText

Représente le contenu texte rendu d'un nœud et de ses descendants. Comme accesseur, il se comporte comme la propriété HTMLElement.innerText (il représente le contenu texte rendu 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 tout saut de ligne en éléments HTML <br>.

HTMLElement.popover

Obtient et définit l'état de la fenêtre contextuelle (popover en anglais) d'un élément via JavaScript ("auto", "hint" ou "manual"), et peut être utilisé pour la détection de fonctionnalité. Reflète la valeur de l'attribut HTML universel popover.

HTMLElement.spellcheck

Un booléen 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

Un booléen représentant la traduction.

HTMLElement.virtualKeyboardPolicy Expérimental

Une chaîne de caractères indiquant le comportement du clavier virtuel à l'écran sur les appareils tels que les tablettes, les téléphones mobiles ou d'autres appareils où un clavier matériel peut ne pas être disponible, si le contenu de l'élément est éditable (par exemple, s'il s'agit d'un élément HTML <input>, <textarea>, ou d'un élément dont l'attribut contenteditable est défini).

HTMLElement.writingSuggestions

Une chaîne de caractères indiquant si les suggestions d'écriture fournies par le navigateur doivent être activées ou non dans le cadre de l'élément.

Méthodes d'instance

Hérite également des méthodes de son parent, Element.

HTMLElement.attachInternals()

Retourne un objet ElementInternals et active la participation d'un élément personnalisé aux formulaires HTML.

HTMLElement.blur()

Retire la sélection clavier de l'élément qui a la sélection.

HTMLElement.click()

Envoie un évènement de clic de souris à l'élément.

HTMLElement.focus()

Passe la sélection clavier à l'élément courant.

HTMLElement.hidePopover()

Masque un élément de fenêtre contextuelle (popover en anglais) en le retirant de la couche supérieure et en lui appliquant le style display: none.

HTMLElement.showPopover()

Affiche un élément de fenêtre contextuelle (popover en anglais) en l'ajoutant à la couche supérieure et en retirant display: none; de ses styles.

HTMLElement.togglePopover()

Bascule un élément de fenêtre contextuelle (popover en anglais) entre les états masqué et affiché.

Évènements

Écoutez ces évènements en utilisant addEventListener() ou en affectant un gestionnaire d'évènement à la propriété onnomevenement de cette interface.

Hérite également des évènements de son parent, Element.

change

Déclenché lorsque la propriété value d'un élément <input>, <select> ou <textarea> a été modifiée et validée par l'utilisateur·ice. Contrairement à l'évènement input, l'évènement change n'est pas nécessairement déclenché pour chaque modification de la propriété value d'un élément.

command

Déclenché sur un élément contrôlé via un bouton avec des valeurs valides pour commandForElement et command, chaque fois que le bouton est utilisé (par exemple, lors d'un clic).

error

Déclenché lorsqu'une ressource n'a pas pu être chargée ou ne peut pas être utilisée.

load

Déclenché pour les éléments contenant une ressource lorsque celle-ci a été chargée avec succès.

Évènements de glisser-déposer

drag

Déclenché lorsqu'un élément ou une sélection de texte est en train d'être déplacé.

dragend

Déclenché lorsqu'une opération de déplacement se termine (en relâchant un bouton de la souris ou en appuyant sur la touche Échap).

dragenter

Déclenché lorsqu'un élément ou une sélection de texte déplacé entre dans une cible de dépôt valide.

dragleave

Déclenché lorsqu'un élément ou une sélection de texte déplacé quitte une cible de dépôt valide.

dragover

Déclenché en continu lorsqu'un élément ou une sélection de texte est en train d'être déplacé et que le pointeur de la souris se trouve au‑dessus d'une cible de dépôt valide (toutes les 50 ms lorsque la souris ne bouge pas, sinon beaucoup plus rapidement, environ entre 5 ms (mouvement lent) et 1 ms (mouvement rapide)). Ce schéma de déclenchement est différent de mouseover.

dragstart

Déclenché lorsque l'utilisateur·ice commence à déplacer un élément ou une sélection de texte.

drop

Déclenché lorsqu'un élément ou une sélection de texte est déposé sur une cible de dépôt valide.

Évènements d'initiateur d'intérêt

interest Expérimental Non standard

Déclenché sur l'élément cible d'un initiateur d'intérêt lorsque l'intérêt est affiché, permettant d'exécuter du code en réponse.

loseinterest Expérimental Non standard

Déclenché sur l'élément cible d'un initiateur d'intérêt lorsque l'intérêt est perdu, permettant d'exécuter du code en réponse.

Évènements de bascule

beforetoggle

Déclenché lorsque l'élément est une fenêtre contextuelle ou <dialog>, avant qu'il ne soit masqué ou affiché.

toggle

Déclenché lorsque l'élément est une fenêtre contextuelle, <dialog> ou <details>, juste après qu'il ait été masqué ou affiché.

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'interface Element