Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Event : propriété explicitOriginalTarget

Non standard: Cette fonctionnalité n'est pas standardisée. Nous déconseillons d'utiliser des fonctionnalités non standard en production, car leur prise en charge par les navigateurs est limitée, et elles peuvent être modifiées ou supprimées. Toutefois, elles peuvent constituer une alternative appropriée dans certains cas où aucune option standard n'existe.

Note : Cette fonctionnalité est disponible via les Web Workers.

La propriété en lecture seule explicitOriginalTarget de l'interface Event retourne la cible originale, non-anonyme, de l'évènement.

Si l'évènement a été re-ciblé pour une autre raison que le franchissement de limites anonyme, cette propriété est définie avec la cible avant le re-ciblage.

Par exemple, les évènements de souris sont re-ciblés sur les nœuds parent lorsqu'ils se produisent sur des nœuds texte (voir le bogue Firefox 185889), et, dans ce cas, currentTarget affiche le parent tandis que cette propriété affiche le nœud texte.

Cette propriété diffère également de originalTarget, car elle ne contient jamais de contenu anonyme.

Valeur

Retourne l'objet EventTarget ou null s'il n'y en a pas.

Exemples

Cette propriété peut être utilisée avec <command> pour obtenir les détails de l'évènement de l'objet original appelant la commande.

js
function maCommande(ev) {
  alert(ev.explicitOriginalTarget.nodeName); // retourne 'menuitem'
}
xml
<xul:command id="my-cmd-anAction" oncommand="maCommande(event);"/>

<xul:menulist>
  <xul:menupopup>
    <xul:menuitem label="Obtenir le nom de mon élément !" command="my-cmd-anAction"/>
  </xul:menupopup>
</xul:menulist>

Spécifications

Il s'agit d'une propriété propre à Mozilla qui ne fait partie d'aucune spécification actuelle. Elle n'est pas en passe de devenir une norme.

Compatibilité des navigateurs