Event.currentTarget
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.
La propriété currentTarget
, accessible en lecture seule et rattachée à l'interface Event
, 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 que Event.target
identifie l'élément à partir duquel l'évènement s'est produit (event.target
peut donc être un descendant de event.currentTarget
).
Syntaxe
var currentEventTarget = event.currentTarget;
Valeur
Exemples
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 console
document.body.addEventListener("click", hide, false);
Note :
La valeur de event.currentTarget
est uniquement disponible lorsque l'évènement est géré. Ainsi, on ne pourra pas observer la valeur de currentTarget
a 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 valeur null
).
Spécifications
Specification |
---|
DOM Standard # ref-for-dom-event-currenttarget② |
Compatibilité des navigateurs
BCD tables only load in the browser