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.
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'attributstyle
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 vautfalse
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é.
-
Un objet
HTMLMenuElement
qui représente le menu contextuel associé à l'élément. Il peut valoirnull
. 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.
-
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émentoffsetParent
. 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émentoffsetParent
. 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'attributstyle
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è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 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