Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
Event.currentTarget
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.
La propriétécurrentTarget, accessible en lecture seule et rattachée à l'interfaceEvent, identifie la cible courante pour l'évènement lorsque celui-ci traverse le DOM. Elle fait toujours référence à l'élément sur lequel le gestionnaire d'évènement a été attaché tandis queEvent.target identifie l'élément à partir duquel l'évènement s'est produit (event.target peut donc être un descendant deevent.currentTarget).
Syntaxe
var currentEventTarget = event.currentTarget;Valeur
EventTargetExemples
Event.currentTarget peut s'avérer utile lorsqu'on attache le même gestionnaire d'évènement à plusieurs éléments.
// Cette fonction masque la cible courante de l'évènement// et l'affiche dans la console.function hide(e) { e.currentTarget.style.visibility = "hidden"; console.log(e.currentTarget); // Lorsque cette fonction est utilisée en gestionnaire d'évènement // on aura this === e.currentTarget}var ps = document.getElementsByTagName("p");for (var i = 0; i < ps.length; i++) { // On affiche l'élément <p> qui a été cliqué dans la console ps[i].addEventListener("click", hide, false);}// On affiche l'élément <body> dans la consoledocument.body.addEventListener("click", hide, false);Note :La valeur deevent.currentTarget estuniquement disponible lorsque l'évènement est géré. Ainsi, on ne pourra pas observer la valeur decurrentTargeta posteriori (ex. si on a stocké la valeur d'event dans une variable lors de la gestion de l'évènement puis qu'on utilise celle-ci plus tard,event.currentTarget aura la valeurnull).
Spécifications
| Specification |
|---|
| DOM # ref-for-dom-event-currenttarget② |