HTMLElement
===========

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

HTMLElementProprié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` (en-US) 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` (en-US) 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` (en-US) qui représente le menu contextuel associé à l'élément. Il peut valoir `null`.

`HTMLElement.dataset` Lecture seule 

Renvoie un objet `DOMStringMap` (en-US) 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` (en-US)

Une valeur booléenne indiquant si l'élément peut être déplacé.

`HTMLElement.enterkeyhint` (en-US)

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` (en-US)

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` (en-US)

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` (en-US)

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` (en-US) 
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` (en-US).

`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` (en-US).

`TouchEventHandlers.ontouchcancel` 
Non-standard

Renvoie le code de gestion d'évènement pour l'évènement `touchcancel` (en-US).

Méthodes
--------

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

`HTMLElement.attachInternals()` (en-US) 
Expérimental

Renvoie un objet `ElementInternals` (en-US) 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` (en-US)

Déclenché lorsque l'utilisatrice ou l'utilisateur initie une action de copier via l'interface du navigateur.

`cut` (en-US)

Déclenché lorsque l'utilisatrice ou l'utilisateur initie une action de couper via l'interface du navigateur.

`paste` (en-US)

Déclenché lorsque l'utilisatrice ou l'utilisateur initie une action de coller via l'interface du navigateur.

`invalid` (en-US)

Déclenché lorsqu'un élément ne respecte pas les contraintes pendant la validation de contrainte. Également disponible via la propriété `onvalid` (en-US).

### Évènements relatifs aux animations

`animationcancel` (en-US)

Déclenché lorsqu'une animation se termine de manière inattendue. Également disponible via la propriété `onanimationcancel` (en-US).

`animationend`

Déclenché lorsqu'une animation se termine normalement. Également disponible via la propriété `onanimationend` (en-US).

`animationiteration`

Déclenché lorsqu'une itération d'une animation est terminée. Également disponible via la propriété `onanimationiteration` (en-US).

`animationstart`

Déclenché lorsqu'une animation démarre. Également disponible via la propriété `onanimationstart` (en-US).

### É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` (en-US).

`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` (en-US)

Déclenché lorsqu'un élément capture un pointeur à l'aide de `setPointerCapture()`. Également disponible via la propriété `ongotpointercapture`.

`lostpointercapture` (en-US)

Déclenché lorsqu'un pointeur capturé est relâché. Également disponible via la propriété `onlostpointercapture` (en-US).

`pointercancel` (en-US)

Déclenché lorsqu'un évènement de pointeur est annulé. Également disponible via la propriété `onpointercancel` (en-US).

`pointerdown` (en-US)

Déclenché lorsqu'un pointeur devient actif. Également disponible via la propriété `onpointerdown` (en-US).

`pointerenter` (en-US)

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` (en-US).

`pointerleave` (en-US)

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` (en-US).

`pointermove` (en-US)

Déclenché lorsqu'un pointeur change de coordonnées. Également disponible via la propriété `onpointermove` (en-US).

`pointerout` (en-US)

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` (en-US).

`pointerover` (en-US)

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` (en-US).

`pointerup` (en-US)

Déclenché lorsqu'un pointeur n'est plus actif. Également disponible via la propriété `onpointerup` (en-US).

### Évènements de transition

`transitioncancel` (en-US)

Déclenché lorsqu'une transition CSS est annulée. Également disponible via la propriété `ontransitioncancel` (en-US).

`transitionend`

Déclenché lorsqu'une transition CSS est terminée. Également disponible via la propriété `ontransitionend` (en-US).

`transitionrun` (en-US)

Déclenché lorsqu'une transition CSS est initialement créée. Également disponible via la propriété `ontransitionrun`.

`transitionstart` (en-US)

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 with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `Element`