diff options
author | Sylvain <sylmarch@laposte.net> | 2021-07-21 21:46:15 +0200 |
---|---|---|
committer | GitHub <noreply@github.com> | 2021-07-21 21:46:15 +0200 |
commit | 4cbda8c778e263c5e6e07b5c157879d5330d9595 (patch) | |
tree | 6776c5027dd78f3f94b7d22ba782259676b31f15 /files/fr | |
parent | 80626951aa5a1828d88978ee7f6f373de574f38e (diff) | |
download | translated-content-4cbda8c778e263c5e6e07b5c157879d5330d9595.tar.gz translated-content-4cbda8c778e263c5e6e07b5c157879d5330d9595.tar.bz2 translated-content-4cbda8c778e263c5e6e07b5c157879d5330d9595.zip |
Fix link to Event.stopPropagation() (#1632)
* Fix link to Event.stopPropagation()
* Fix link to Event.stopPropagation() on Event.cancelBubble description
* Update whole page vs en-US counterpart
* Fixing typos
Co-authored-by: SphinxKnight <julien.gattelier@gmail.com>
Diffstat (limited to 'files/fr')
-rw-r--r-- | files/fr/web/api/event/index.html | 268 |
1 files changed, 127 insertions, 141 deletions
diff --git a/files/fr/web/api/event/index.html b/files/fr/web/api/event/index.html index bf5ecf5351..b8c7a25d24 100644 --- a/files/fr/web/api/event/index.html +++ b/files/fr/web/api/event/index.html @@ -1,183 +1,169 @@ --- title: Event slug: Web/API/Event -tags: - - API - - DOM - - Evènement - - Interface - - Reference - - interface utilisateur +browser-compat: api.Event translation_of: Web/API/Event --- <p>{{APIRef("DOM")}}</p> -<p>L'interface <code><strong>Event</strong></code> <span id="result_box" lang="fr"><span>représente tout événement qui a lieu dans le DOM ;</span> <span>certains sont générés par l'utilisateur (tels que des événements de souris ou de clavier), tandis que d'autres sont générés par des API (par exemple, des événements indiquant qu'une animation est terminée, qu'une vidéo a été suspendue, etc.).</span> <span>Il existe plusieurs types d'événements, dont certains utilisent d'autres interfaces basées sur l'interface principale <code>Event</code>.</span> <code>Event</code><span> elle-même contient les propriétés et méthodes communes à tous les événements.</span></span></p> +<p>L'interface <code><strong>Event</strong></code> interface représente un évènement qui se produit dans le DOM.</p> -<h2 id="Interfaces_basées_sur_Event"><span lang="fr"><span>Interfaces basées sur <code>Event</code></span></span></h2> +<p>Un évènement peut être déclenché par une action humaine (clic avec la souris, appui sur une touche du clavier) ou généré par des API pour représenter la progression d'une tâche asynchrone. Il est également possible de déclencher un évènement à partir d'un programme, en appelant par exemple la méthode <a href="/fr/docs/Web/API/HTMLElement/click"><code>HTMLElement.click()</code></a> sur un élément ou en définissant l'évènement avant de l'envoyer sur une cible avec la méthode <a href="/fr/docs/Web/API/EventTarget/dispatchEvent"><code>EventTarget.dispatchEvent()</code></a>.</p> -<p> <span id="result_box" lang="fr"><span>Voici une liste d'interfaces basées sur l'interface principale </span></span> <code>Event</code> <span lang="fr"><span>, avec des liens vers leur documentation respective dans la référence de l'API MDN.</span> <span>Notez que toutes les interfaces d'événements ont des noms qui se terminent par "Event".</span></span></p> +<p>Il existe de nombreux types d'évènements dont certains utilisent d'autres interfaces basées sur <code>Event</code>. L'interface <code>Event</code> contient les propriétés et méthodes qui sont communes à l'ensemble des évènements.</p> + +<p>De nombreux éléments DOM peuvent être paramétrés afin d'accepter (« d'écouter ») ces évènements et d'exécuter du code en réaction afin de les traiter (« gérer »). Les gestionnaires d'évènements sont généralement connectés (« attachés ») aux <a href="/fr/docs/Web/HTML/Element">éléments HTML</a> (tels que <code><button></code>, <code><div></code>, <code><span></code>, etc.) grâce à la méthode <a href="/fr/docs/Web/API/EventTarget/addEventListener"><code>EventTarget.addEventListener()</code></a> qui remplace les anciens <a href="/fr/docs/Web/HTML/Global_attributes">attributs de gestion d'évènement</a> qui étaient auparavant utilisés en HTML. Avec cette méthode d'ajout plus récente, les gestionnaires peuvent également être déconnectés/détachés si besoin via la méthode <a href="/fr/docs/Web/API/EventTarget/removeEventListener"><code>EventTarget.removeEventListener()</code></a>.</p> + +<div class="notecard note"> +<p><strong>Note :</strong> Il est tout à fait possible d'attacher plusieurs gestionnaires d'évènement à un seul élément, y compris pour la gestion d'un évènement particulier. Ainsi, des modules de code indépendant peuvent attacher leurs gestionnaires de façon indépendante (par exemple, sur une page web, un module de publicité et un autre module d'analyse pourront tout à fait attacher des gestionnaires pour étudier la consultation d'une vidéo).</p> +</div> + +<p>Lorsqu'il y a de nombreux éléments imbriqués, chacun ayant ses propres gestionnaires d'évènement, le traitement des évènements peut se révéler compliqué, notamment lorsqu'un élément parent reçoit le même évènement que ses éléments enfants (par exemple pour des évènements qui se déclenchent sur la surface visuelle de l'élément enfant). Dans ce cas, l'ordre du traitement de ces évènements dépend des paramètres <a href="/fr/docs/Learn/JavaScript/Building_blocks/Events#event_bubbling_and_capture">de bouillonnement (<i>bubbling</i>) et de capture</a> définis sur chaque gestionnaire ainsi déclenché.</p> + +<h2 id="introduction">Interfaces basées sur Event</h2> + +<p>Voici une liste des interfaces basées sur <code>Event</code> avec un lien vers leur documentation dans la référence MDN.</p> + +<p>On notera que l'ensemble des interfaces d'évènements ont un nom qui termine par <i>Event</i> (« évènement » en anglais).</p> <div class="index"> <ul> - <li>{{domxref("AnimationEvent")}}</li> - <li>{{domxref("AudioProcessingEvent")}}</li> - <li>{{domxref("BeforeInputEvent")}}</li> - <li>{{domxref("BeforeUnloadEvent")}}</li> - <li>{{domxref("BlobEvent")}}</li> - <li>{{domxref("ClipboardEvent")}}</li> - <li>{{domxref("CloseEvent")}}</li> - <li>{{domxref("CompositionEvent")}}</li> - <li>{{domxref("CSSFontFaceLoadEvent")}}</li> - <li>{{domxref("CustomEvent")}}</li> - <li>{{domxref("DeviceLightEvent")}}</li> - <li>{{domxref("DeviceMotionEvent")}}</li> - <li>{{domxref("DeviceOrientationEvent")}}</li> - <li>{{domxref("DeviceProximityEvent")}}</li> - <li>{{domxref("DOMTransactionEvent")}}</li> - <li>{{domxref("DragEvent")}}</li> - <li>{{domxref("EditingBeforeInputEvent")}}</li> - <li>{{domxref("ErrorEvent")}}</li> - <li>{{domxref("FetchEvent")}}</li> - <li>{{domxref("FocusEvent")}}</li> - <li>{{domxref("GamepadEvent")}}</li> - <li>{{domxref("HashChangeEvent")}}</li> - <li>{{domxref("IDBVersionChangeEvent")}}</li> - <li>{{domxref("InputEvent")}}</li> - <li>{{domxref("KeyboardEvent")}}</li> - <li>{{domxref("MediaStreamEvent")}}</li> - <li>{{domxref("MessageEvent")}}</li> - <li>{{domxref("MouseEvent")}}</li> - <li>{{domxref("MutationEvent")}}</li> - <li>{{domxref("OfflineAudioCompletionEvent")}}</li> - <li>{{domxref("PageTransitionEvent")}}</li> - <li>{{domxref("PointerEvent")}}</li> - <li>{{domxref("PopStateEvent")}}</li> - <li>{{domxref("ProgressEvent")}}</li> - <li>{{domxref("RelatedEvent")}}</li> - <li>{{domxref("RTCDataChannelEvent")}}</li> - <li>{{domxref("RTCIdentityErrorEvent")}}</li> - <li>{{domxref("RTCIdentityEvent")}}</li> - <li>{{domxref("RTCPeerConnectionIceEvent")}}</li> - <li>{{domxref("SensorEvent")}}</li> - <li>{{domxref("StorageEvent")}}</li> - <li>{{domxref("SVGEvent")}}</li> - <li>{{domxref("SVGZoomEvent")}}</li> - <li>{{domxref("TimeEvent")}}</li> - <li>{{domxref("TouchEvent")}}</li> - <li>{{domxref("TrackEvent")}}</li> - <li>{{domxref("TransitionEvent")}}</li> - <li>{{domxref("UIEvent")}}</li> - <li>{{domxref("UserProximityEvent")}}</li> - <li>{{domxref("WebGLContextEvent")}}</li> - <li>{{domxref("WheelEvent")}}</li> + <li><a href="/fr/docs/Web/API/AnimationEvent"><code>AnimationEvent</code></a></li> + <li><a href="/fr/docs/Web/API/AudioProcessingEvent"><code>AudioProcessingEvent</code></a></li> + <li><a href="/fr/docs/Web/API/BeforeInputEvent"><code>BeforeInputEvent</code></a></li> + <li><a href="/fr/docs/Web/API/BeforeUnloadEvent"><code>BeforeUnloadEvent</code></a></li> + <li><a href="/fr/docs/Web/API/BlobEvent"><code>BlobEvent</code></a></li> + <li><a href="/fr/docs/Web/API/ClipboardEvent"><code>ClipboardEvent</code></a></li> + <li><a href="/fr/docs/Web/API/CloseEvent"><code>CloseEvent</code></a></li> + <li><a href="/fr/docs/Web/API/CompositionEvent"><code>CompositionEvent</code></a></li> + <li><a href="/fr/docs/Web/API/CSSFontFaceLoadEvent"><code>CSSFontFaceLoadEvent</code></a></li> + <li><a href="/fr/docs/Web/API/CustomEvent"><code>CustomEvent</code></a></li> + <li><a href="/fr/docs/Web/API/DeviceMotionEvent"><code>DeviceMotionEvent</code></a></li> + <li><a href="/fr/docs/Web/API/DeviceOrientationEvent"><code>DeviceOrientationEvent</code></a></li> + <li><a href="/fr/docs/Web/API/DeviceProximityEvent"><code>DeviceProximityEvent</code></a></li> + <li><a href="/fr/docs/Web/API/DOMTransactionEvent"><code>DOMTransactionEvent</code></a></li> + <li><a href="/fr/docs/Web/API/DragEvent"><code>DragEvent</code></a></li> + <li><a href="/fr/docs/Web/API/EditingBeforeInputEvent"><code>EditingBeforeInputEvent</code></a></li> + <li><a href="/fr/docs/Web/API/ErrorEvent"><code>ErrorEvent</code></a></li> + <li><a href="/fr/docs/Web/API/FetchEvent"><code>FetchEvent</code></a></li> + <li><a href="/fr/docs/Web/API/FocusEvent"><code>FocusEvent</code></a></li> + <li><a href="/fr/docs/Web/API/GamepadEvent"><code>GamepadEvent</code></a></li> + <li><a href="/fr/docs/Web/API/HashChangeEvent"><code>HashChangeEvent</code></a></li> + <li><a href="/fr/docs/Web/API/IDBVersionChangeEvent"><code>IDBVersionChangeEvent</code></a></li> + <li><a href="/fr/docs/Web/API/InputEvent"><code>InputEvent</code></a></li> + <li><a href="/fr/docs/Web/API/KeyboardEvent"><code>KeyboardEvent</code></a></li> + <li><a href="/fr/docs/Web/API/MediaStreamEvent"><code>MediaStreamEvent</code></a></li> + <li><a href="/fr/docs/Web/API/MessageEvent"><code>MessageEvent</code></a></li> + <li><a href="/fr/docs/Web/API/MouseEvent"><code>MouseEvent</code></a></li> + <li><a href="/fr/docs/Web/API/MutationEvent"><code>MutationEvent</code></a></li> + <li><a href="/fr/docs/Web/API/OfflineAudioCompletionEvent"><code>OfflineAudioCompletionEvent</code></a></li> + <li><a href="/fr/docs/Web/API/OverconstrainedError"><code>OverconstrainedError</code></a></li> + <li><a href="/fr/docs/Web/API/PageTransitionEvent"><code>PageTransitionEvent</code></a></li> + <li><a href="/fr/docs/Web/API/PaymentRequestUpdateEvent"><code>PaymentRequestUpdateEvent</code></a></li> + <li><a href="/fr/docs/Web/API/PointerEvent"><code>PointerEvent</code></a></li> + <li><a href="/fr/docs/Web/API/PopStateEvent"><code>PopStateEvent</code></a></li> + <li><a href="/fr/docs/Web/API/ProgressEvent"><code>ProgressEvent</code></a></li> + <li><a href="/fr/docs/Web/API/RelatedEvent"><code>RelatedEvent</code></a></li> + <li><a href="/fr/docs/Web/API/RTCDataChannelEvent"><code>RTCDataChannelEvent</code></a></li> + <li><a href="/fr/docs/Web/API/RTCPeerConnectionIceEvent"><code>RTCPeerConnectionIceEvent</code></a></li> + <li><a href="/fr/docs/Web/API/SensorEvent"><code>SensorEvent</code></a></li> + <li><a href="/fr/docs/Web/API/StorageEvent"><code>StorageEvent</code></a></li> + <li><a href="/fr/docs/Web/API/SVGEvent"><code>SVGEvent</code></a></li> + <li><a href="/fr/docs/Web/API/SVGZoomEvent"><code>SVGZoomEvent</code></a></li> + <li><a href="/fr/docs/Web/API/TimeEvent"><code>TimeEvent</code></a></li> + <li><a href="/fr/docs/Web/API/TouchEvent"><code>TouchEvent</code></a></li> + <li><a href="/fr/docs/Web/API/TrackEvent"><code>TrackEvent</code></a></li> + <li><a href="/fr/docs/Web/API/TransitionEvent"><code>TransitionEvent</code></a></li> + <li><a href="/fr/docs/Web/API/UIEvent"><code>UIEvent</code></a></li> + <li><a href="/fr/docs/Web/API/UserProximityEvent"><code>UserProximityEvent</code></a></li> + <li><a href="/fr/docs/Web/API/WebGLContextEvent"><code>WebGLContextEvent</code></a></li> + <li><a href="/fr/docs/Web/API/WheelEvent"><code>WheelEvent</code></a></li> </ul> </div> -<h2 id="L.27interface_DOM_Event" name="L.27interface_DOM_Event">Constructeur</h2> - -<p><span class="comment">L'interface DOM <code>event</code> est exposée dans les objets <code>event</code> qui sont passés aux gestionnaires d'évènements sur divers éléments du DOM.</span></p> +<h2 id="constructor">Constructeur</h2> <dl> - <dt>{{domxref("Event.Event", "Event()")}}</dt> - <dd>Crée un objet Event le retournant à l'appelant.</dd> + <dt><a href="/fr/docs/Web/API/Event/Event"><code>Event()</code></dt> + <dd>Crée un objet <code>Event</code> et le renvoie à l'appelant.</dd> </dl> -<h2 id="Propri.C3.A9t.C3.A9s" name="Propri.C3.A9t.C3.A9s">Propriétés</h2> +<h2 id="properties">Propriétés</h2> <dl> - <dt>{{domxref("Event.bubbles")}} {{readonlyinline}}</dt> - <dd>un booléen indiquant si l'évènement se propage vers le haut dans le DOM ou non.</dd> - <dt>{{domxref("Event.cancelBubble")}}</dt> - <dd>u<span id="result_box" lang="fr"><span>n alias historique de {{domxref ("Event.stopPropagation ()")}}.</span> <span>Définir sa valeur sur <code>true,</code> avant qu'elle revienne d'un gestionnaire d'événements, empêche la propagation de l'événement.</span></span></dd> - <dt>{{domxref("Event.cancelable")}} {{readonlyinline}}</dt> - <dd>Un booléen indiquant si l'évènement est annulable.</dd> - <dt>{{domxref("Event.composed")}} {{ReadOnlyInline}}</dt> - <dd><span id="result_box" lang="fr"><span>Un booléen indiquant si l'événement peut ou non traverser la frontière entre le DOM shadow et le DOM normal.</span></span></dd> - <dt>{{domxref("Event.currentTarget")}} {{readonlyinline}}</dt> - <dd><span id="result_box" lang="fr"><span>Une référence à la cible actuellement enregistrée pour l'événement.</span> <span>C'est l'objet auquel l'événement doit actuellement être envoyé ;</span> <span>il est possible que cela ait été modifié au cours du reciblage.</span></span></dd> - <dt>{{domxref("Event.deepPath")}} {{non-standard_inline}}</dt> - <dd>Un {{jsxref("Array")}} (<em>tableau</em>) de {{domxref("Node")}} DOM à travers lesquels l'event a été propagé.</dd> - <dt>{{domxref("Event.defaultPrevented")}} {{readonlyinline}}</dt> - <dd>indique si {{domxref("event.preventDefault()")}} a été appelé ou non dans l'événement.</dd> - <dt>{{domxref("Event.eventPhase")}} {{readonlyinline}}</dt> - <dd>indique dans quelle phase de l'évènement on se trouve actuellement.</dd> - <dt>{{domxref("Event.explicitOriginalTarget")}} {{non-standard_inline}} {{readonlyinline}}</dt> - <dd>La cible explicite originale de l'évènement (spécifique à Mozilla).</dd> - <dt>{{domxref("Event.originalTarget")}} {{non-standard_inline}} {{readonlyinline}}</dt> - <dd>La cible originale de l'évènement, avant toute modification de celle-ci (spécifique à Mozilla).</dd> - <dt>{{domxref("Event.returnValue")}} {{non-standard_inline}}</dt> - <dd>une alternative non standard (de versions anciennes de MS IE) de {{domxref("Event.preventDefault()")}} et {{domxref("Event.defaultPrevented")}}.</dd> - <dt>{{domxref("Event.srcElement")}} {{non-standard_inline}}</dt> - <dd>Un alias non standard (d'anciennes versions de MS IE) pour {{domxref("Event.target")}}.</dd> - <dt>{{domxref("Event.target")}} {{readonlyinline}}</dt> - <dd>une référence à la cible vers laquelle l'évènement était originellement destiné.</dd> - <dt>{{domxref("Event.timeStamp")}} {{readonlyinline}}</dt> - <dd>Le moment de création de l'évènement, en millisecondes. <span id="result_box" lang="fr"><span>Par spécification, cette valeur est le temps écoulé depuis le moment, mais en réalité les définitions des navigateurs varient ;</span> <span>en outre, le travail est en cours pour le changer en </span></span> {{domxref("DOMHighResTimeStamp")}}.</dd> - <dt>{{domxref("Event.type")}} {{readonlyinline}}</dt> - <dd>Le nom de l'évènement (insensible à la casse).</dd> - <dt>{{domxref("Event.isTrusted")}} {{readonlyinline}}</dt> - <dd>indique si l'évènement est initié par le navigateur ou non (après un click d'utilisateur ou par un script utilisant une méthode de création d'évènement comme <a href="https://developer.mozilla.org/fr/docs/Web/API/Event/initEvent">event.initEvent</a>)</dd> + <dt><a href="/fr/docs/Web/API/Event/bubbles"><code>Event.bubbles</code></a> {{readonlyinline}}</dt> + <dd>Un booléen qui indique si l'évènement bouillonne/remonte vers le haut dans l'arbre du DOM.</dd> + <dt><a href="/fr/docs/Web/API/Event/cancelBubble"><code>Event.cancelBubble</code></a></dt> + <dd>Un alias historique de <a href="/fr/docs/Web/API/Event/stopPropagation"><code>Event.stopPropagation()</code></a>. Définir sa valeur à <code>true</code> avant le retour d'un gestionnaire d'évènement empêchera la propagation de l'évènement.</dd> + <dt><a href="/fr/docs/Web/API/Event/cancelable"><code>Event.cancelable</code></a> {{readonlyinline}}</dt> + <dd>Un booléen qui indique si l'évènement peut être annulé.</dd> + <dt><a href="/fr/docs/Web/API/Event/composed"><code>Event.composed</code></a> {{ReadOnlyInline}}</dt> + <dd>Un booléen qui indique si l'évènement peut bouillonner entre l'arbre du shadow DOM et le DOM standard.</dd> + <dt><a href="/fr/docs/Web/API/Event/currentTarget"><code>Event.currentTarget</code></a> {{readonlyinline}}</dt> + <dd>Une référence vers la cible actuellement enregistrée pour l'évènement. Il s'agit de l'objet vers lequel l'évènement est présentement destiné à être envoyé. Cette cible peut avoir été modifiée pendant la vie de l'évènement via un reciblage.</dd> + <dt><a href="/fr/docs/Web/API/Event/deepPath"><code>Event.deepPath</code></a> {{non-standard_inline}}</dt> + <dd>Un tableau (<a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Array"><code>Array</code></a>) de nœuds (<a href="/fr/docs/Web/API/Node"><code>Node</code></a>) du DOM qui ont été parcourus lors du bouillonnement/de la remontée de l'évènement.</dd> + <dt><a href="/fr/docs/Web/API/Event/defaultPrevented"><code>Event.defaultPrevented</code></a> {{readonlyinline}}</dt> + <dd>Indique si un appel à <a href="/fr/docs/Web/API/Event/preventDefault"><code>Event.preventDefault()</code></a> a annulé l'évènement.</dd> + <dt><a href="/fr/docs/Web/API/Event/eventPhase"><code>Event.eventPhase</code></a> {{readonlyinline}}</dt> + <dd>Indique la phase du flux de l'évènement qui est en cours de traitement.</dd> + <dt><a href="/fr/docs/Web/API/Event/explicitOriginalTarget"><code>Event.explicitOriginalTarget</code></a> {{non-standard_inline}} {{readonlyinline}}</dt> + <dd>La cible explicite et originnelle de l'évènement (spécifique à Mozilla).</dd> + <dt><a href="/fr/docs/Web/API/Event/originalTarget"><code>Event.originalTarget</code></a> {{non-standard_inline}} {{readonlyinline}}</dt> + <dd>La cible originale de l'évènement avant tout reciblage (spécifique à Mozilla).</dd> + <dt><a href="/fr/docs/Web/API/Event/returnValue"><code>Event.returnValue</code></a> {{Deprecated_Inline}}</dt> + <dd>Une propriété historique, introduite par Internet Explorer puis adoptée au sein de la spécification du DOM pour la compatibilité des sites existants. À la place, on privilégiera l'usage de <a href="/fr/docs/Web/API/Event/preventDefault"><code>Event.preventDefault()</code></a> et <a href="/fr/docs/Web/API/Event/defaultPrevented"><code>Event.defaultPrevented</code></a>.</dd> + <dt><a href="/fr/docs/Web/API/Event/srcElement"><code>Event.srcElement</code></a> {{non-standard_inline}}</dt> + <dd>Un alias non-standard (provenant d'anciennes versions d'Internet Explorer) pour <a href="/fr/docs/Web/API/Event/target"><code>Event.target</code></a>. Certains navigateurs le prennent en charge à des fins de compatibilité web.</dd> + <dt><a href="/fr/docs/Web/API/Event/target"><code>Event.target</code></a> {{readonlyinline}}</dt> + <dd>Une référence à la cible à laquelle l'évènement était initialement destiné.</dd> + <dt><a href="/fr/docs/Web/API/Event/timeStamp"><code>Event.timeStamp</code></a> {{readonlyinline}}</dt> + <dd>Le temps auquel l'évènement a été créé (exprimé en millisecondes). La spécification indique que cette valeur est relative à l'epoch mais l'implémentation des navigateurs peut varier. Des travaux sont en cours afin que cette valeur devienne une valeur de type <a href="/fr/docs/Web/API/DOMHighResTimeStamp"><code>DOMHighResTimeStamp</code></a>.</dd> + <dt><a href="/fr/docs/Web/API/Event/type"><code>Event.type</code></a> {{readonlyinline}}</dt> + <dd>Le nom de l'évènement, exprimé de façon insensible à la casse.</dd> + <dt><a href="/fr/docs/Web/API/Event/isTrusted"><code>Event.isTrusted</code></a> {{readonlyinline}}</dt> + <dd>Indique si l'évènement a été initié par le navigateur (suite à une action humaine comme un clic) ou par un script (en utilisant une méthode de création comme <a href="/fr/docs/Web/API/Event/initEvent"><code>Event.initEvent</code></a>).</dd> </dl> -<h3 id="Propriétés_obsolètes">Propriétés obsolètes</h3> +<h3 id="deprecated_properties">Propriétés dépréciées</h3> <dl> - <dt>{{domxref("Event.scoped")}} {{readonlyinline}} {{obsolete_inline}}</dt> - <dd>un {{jsxref("Boolean")}} indiquant si l'événement donné peut être propagé à travers la racine shadow dans le DOM standard. Cette propriété a été renommée {{domxref("Event.composed", "composed")}}.</dd> + <dt><a href="/fr/docs/Web/API/Event/composed"><code>Event.scoped</code></a> {{readonlyinline}} {{deprecated_inline}}</dt> + <dd>Un booléen qui indique si l'évènement courant remontera de l'arbre du shadow DOM vers l'arbre du DOM classique. <a href="/fr/docs/Web/API/Event/composed"><code>Event.composed</code></a> doit être utilisé à la place.</dd> </dl> -<h2 id="M.C3.A9thodes" name="M.C3.A9thodes">Méthodes</h2> +<h2 id="methods">Méthodes</h2> <dl> - <dt>{{domxref("Event.createEvent()")}} </dt> - <dd>Crée un nouvel <code>Event</code> (<em>évènement</em>) qui doit alors être initialisé par l'appel à la méthode <code>initEvent()</code>.</dd> - <dt>{{domxref("Event.composedPath()")}}</dt> - <dd>Renvoie le chemin de l'événement (objets sur lesquels les écouteurs seront appelés). Cela n'inclut pas les noeuds dans les arbres shadow si la racine shadow a été créée avec son {{domxref("ShadowRoot.mode")}} fermé.</dd> - <dt>{{domxref("Event.initEvent()")}} {{deprecated_inline}}</dt> - <dd>initialise la valeur d'un évènement créé. Si l'évènement a déjà été propagé, la méthode ne produit rien.</dd> - <dt>{{domxref("Event.preventDefault()")}}</dt> - <dd>Annule l'évènement (s'il est annulable).</dd> - <dt>{{domxref("Event.stopImmediatePropagation()")}}</dt> - <dd>Pour cet évènement particulier, aucun autre écouteur ne peut être appelé. <span id="result_box" lang="fr"><span>Ni ceux attachés au même élément, ni ceux attachés aux éléments qui seront traversés plus tard (en phase de capture, par exemple)</span></span></dd> - <dt>{{domxref("Event.stopPropagation()")}}</dt> - <dd>Arrête la propagation ultérieure d'évènements dans le DOM.</dd> + <dt><a href="/fr/docs/Web/API/Event/composedPath"><code>Event.composedPath()</code></a></dt> + <dd>Renvoie le chemin de l'évènement (c'est-à-dire les objets pour lesquels des gestionnaires d'évènements seront appelés). Ce chemin n'inclut pas les nœuds des arbres shadow si la racine shadow a été créée avec un <a href="/fr/docs/Web/API/ShadowRoot/mode"><code>ShadowRoot.mode</code></a>.</dd> + <dt><a href="/fr/docs/Web/API/Event/preventDefault"><code>Event.preventDefault()</code></a></dt> + <dd>Annule l'évènement (si celui-ci peut être annulé).</dd> + <dt><a href="/fr/docs/Web/API/Event/stopImmediatePropagation"><code>Event.stopImmediatePropagation</code></a></dt> + <dd>Pour l'évènement courant, empêche les autres gestionnaires d'évènements d'être appelés. Cela inclut les gestionnaires attachés au même élément ainsi que ceux attachés aux éléments qui seront parcourus ensuite (pendant la phase de capture par exemple).</dd> + <dt><a href="/fr/docs/Web/API/Event/stopPropagation"><code>Event.stopPropagation</code></a></dt> + <dd>Arrête la propagation des évènements plus loin dans le DOM.</dd> </dl> -<h3 id="Méthodes_obsolètes">Méthodes obsolètes</h3> - -<dl> - <dt>{{domxref("Event.preventBubble()")}} {{non-standard_inline}} {{Obsolete_inline(24)}}</dt> - <dd>Empêche l'évènement de se propager. Obsolète, utilisez la méthode {{domxref("event.stopPropagation")}} à la place.</dd> - <dt>{{domxref("Event.preventCapture()")}} {{non-standard_inline}} {{Obsolete_inline(24)}}</dt> - <dd>Obsolète, utilisez la méthode {{domxref("event.stopPropagation")}} à la place.</dd> -</dl> +<h3 id="deprecated_methods">Méthodes dépréciées</h3> <dl> - <dt>{{domxref("Event.getPreventDefault()")}} {{non-standard_inline}}</dt> - <dd>Non standard. Retourne la valeur de {{domxref("Event.defaultPrevented")}}. Utilisez à la place {{domxref("Event.defaultPrevented")}} .</dd> + <dt><a href="/fr/docs/Web/API/Event/initEvent"><code>Event.initEvent()</code></a> {{deprecated_inline}}</dt> + <dd>Initialise la valeur d'un évènement créé. Si l'évènement a déjà diffusé, cette méthode n'a aucun effet.</dd> </dl> -<h2 id="Spécifications">Spécifications</h2> - -<p>Spécification Statut Commentaire {{SpecName('DOM WHATWG', '#interface-event', 'Event')}} {{Spec2('DOM WHATWG')}} </p> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +<h2 id="specifications">Spécifications</h2> +<p>{{Specifications}}</p> +<h2 id="browser_compatibility">Compatibilité des navigateurs</h2> -<p>{{Compat("api.Event")}}</p> +<p>{{Compat}}</p> -<h2 id="Voir_aussi">Voir aussi</h2> +<h2 id="see_also">Voir aussi</h2> <ul> - <li>Types d'évènements disponibles : <a href="https://developer.mozilla.org/fr/docs/Web/Events">Référence Event</a></li> - <li><a href="https://developer.mozilla.org/fr/docs/Web/API/Event/Comparison_of_Event_Targets">Comparaison des cibles d'Event</a> (<span id="result_box" lang="fr"><span>target vs currentTarget vs relatedTarget vs originalTarget</span></span> )</li> - <li><a href="https://developer.mozilla.org/fr/docs/Web/Guide/DOM/Events/Creating_and_triggering_events">Création et déclenchement d'évènements personnalisés</a></li> - <li><span class="short_text" id="result_box" lang="fr"><span>Pour les développeurs de Firefox :</span></span> - <ul> - <li><a href="https://developer.mozilla.org/fr/docs/Listening_to_events_in_Firefox_extensions">Écouter des évènements dans les extensions Firefox</a></li> - <li><a href="https://developer.mozilla.org/fr/docs/Listening_to_events_on_all_tabs">Écouter des événements sur tous les onglets</a></li> - </ul> - </li> + <li>Les types d'évènement disponibles : <a href="/fr/docs/Web/Events">Référence des évènements</a></li> + <li><a href="/fr/docs/Web/API/Event/Comparison_of_Event_Targets">Comparaison des cibles d'évènements</a> (<code>target</code> vs <code>currentTarget</code> vs <code>relatedTarget</code> vs <code>originalTarget</code>)</li> + <li><a href="/fr/docs/Web/Events/Creating_and_triggering_events">Créer et déclencher des évènements personnalisés</a></li> </ul> |