From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/fr/web/api/event/currenttarget/index.html | 94 +++++++++++++++++++++++++ 1 file changed, 94 insertions(+) create mode 100644 files/fr/web/api/event/currenttarget/index.html (limited to 'files/fr/web/api/event/currenttarget') diff --git a/files/fr/web/api/event/currenttarget/index.html b/files/fr/web/api/event/currenttarget/index.html new file mode 100644 index 0000000000..e62854942c --- /dev/null +++ b/files/fr/web/api/event/currenttarget/index.html @@ -0,0 +1,94 @@ +--- +title: Event.currentTarget +slug: Web/API/Event/currentTarget +tags: + - API + - Cible + - DOM + - Evènement + - Propriété +translation_of: Web/API/Event/currentTarget +--- +
{{APIRef("DOM")}}
+ +

La propriété currentTarget, accessible en lecture seule et rattachée à l'interface {{domxref("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 {{domxref("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

+ +

{{domxref("EventTarget")}}

+ +

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

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
SpécificationÉtatCommentaires
{{SpecName("DOM WHATWG", "#dom-event-currenttarget", "Event.currentTarget")}}{{Spec2("DOM WHATWG")}}
{{SpecName("DOM4", "#dom-event-currenttarget", "Event.currentTarget")}}{{Spec2("DOM4")}}
{{SpecName("DOM3 Events", "#dfn-current-event-target", "current event target")}}{{Spec2("DOM3 Events")}}
{{SpecName("DOM2 Events", "#Events-Event-currentTarget", "Event.currentTarget")}}{{Spec2("DOM2 Events")}}Initial definition
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.Event.currentTarget")}}

+ +

Voir aussi

+ + -- cgit v1.2.3-54-g00ecf