diff options
Diffstat (limited to 'files/fr/web/api/document/dragenter_event/index.md')
| -rw-r--r-- | files/fr/web/api/document/dragenter_event/index.md | 255 |
1 files changed, 74 insertions, 181 deletions
diff --git a/files/fr/web/api/document/dragenter_event/index.md b/files/fr/web/api/document/dragenter_event/index.md index 370d84b4d3..4aff1b3c8d 100644 --- a/files/fr/web/api/document/dragenter_event/index.md +++ b/files/fr/web/api/document/dragenter_event/index.md @@ -3,151 +3,61 @@ title: dragenter slug: Web/API/Document/dragenter_event translation_of: Web/API/Document/dragenter_event --- -<div>{{APIRef}}</div> - -<p>L'événement <strong>dragenter</strong> est déclenché lorsqu'un élément glissé ou une sélection de texte entre dans une cible de drop valide.</p> - -<h2>Informations générales</h2> - -<dl> - <dt>Interface</dt> - <dd>{{domxref("DragEvent")}}</dd> - <dt>Propagation</dt> - <dd>Oui</dd> - <dt>Annulable</dt> - <dd>Oui</dd> - <dt>Cible</dt> - <dd>La sélection immédiate de l'utilisateur (l'élément présentement indiqué par l'utilisateur comme cible pour le drop), ou l'élément {{HTMLElement("body")}}.</dd> - <dt>Action par défaut</dt> - <dd>Rejette la sélection immédiate de l'utilisateur comme élément cible potentiel</dd> -</dl> - -<h2 id="Properties">Properties</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Property</th> - <th scope="col">Type</th> - <th scope="col">Description</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>target</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/EventTarget"><code>EventTarget</code></a></td> - <td>The element that was underneath the element being dragged.</td> - </tr> - <tr> - <td><code>type</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/DOMString"><code>DOMString</code></a></td> - <td>The type of event.</td> - </tr> - <tr> - <td><code>bubbles</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/Boolean"><code>Boolean</code></a></td> - <td>Whether the event normally bubbles or not</td> - </tr> - <tr> - <td><code>cancelable</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/Boolean"><code>Boolean</code></a></td> - <td>Whether the event is cancellable or not?</td> - </tr> - <tr> - <td><code>view</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/WindowProxy" rel="nofollow"><code>WindowProxy</code></a></td> - <td><a href="/en-US/docs/Web/API/Document/defaultView"><code>document.defaultView</code></a> (<code>window</code> of the document)</td> - </tr> - <tr> - <td><code>detail</code> {{readonlyInline}}</td> - <td><code>long</code> (<code>float</code>)</td> - <td>0.</td> - </tr> - <tr> - <td><code>dataTransfer</code></td> - <td>DataTransfer</td> - <td>The data that underlies a drag-and-drop operation, known as the <a href="/en-US/docs/Web/API/DataTransfer">drag data store</a>. Protected mode.</td> - </tr> - <tr> - <td><code>currentTarget</code> {{readonlyInline}}</td> - <td>EventTarget</td> - <td>The node that had the event listener attached.</td> - </tr> - <tr> - <td><code>relatedTarget</code> {{readonlyInline}}</td> - <td>EventTarget</td> - <td>For <code>mouseover</code>, <code>mouseout</code>, <code>mouseenter</code> and <code>mouseleave</code> events: the target of the complementary event (the <code>mouseleave</code> target in the case of a <code>mouseenter</code> event). <code>null</code> otherwise.</td> - </tr> - <tr> - <td><code>screenX</code> {{readonlyInline}}</td> - <td>long</td> - <td>The X coordinate of the mouse pointer in global (screen) coordinates.</td> - </tr> - <tr> - <td><code>screenY</code> {{readonlyInline}}</td> - <td>long</td> - <td>The Y coordinate of the mouse pointer in global (screen) coordinates.</td> - </tr> - <tr> - <td><code>clientX</code> {{readonlyInline}}</td> - <td>long</td> - <td>The X coordinate of the mouse pointer in local (DOM content) coordinates.</td> - </tr> - <tr> - <td><code>clientY</code> {{readonlyInline}}</td> - <td>long</td> - <td>The Y coordinate of the mouse pointer in local (DOM content) coordinates.</td> - </tr> - <tr> - <td><code>button</code> {{readonlyInline}}</td> - <td>unsigned short</td> - <td>The button number that was pressed when the mouse event was fired: Left button=0, middle button=1 (if present), right button=2. For mice configured for left handed use in which the button actions are reversed the values are instead read from right to left.</td> - </tr> - <tr> - <td><code>buttons</code> {{readonlyInline}}</td> - <td>unsigned short</td> - <td>The buttons being pressed when the mouse event was fired: Left button=1, Right button=2, Middle (wheel) button=4, 4th button (typically, "Browser Back" button)=8, 5th button (typically, "Browser Forward" button)=16. If two or more buttons are pressed, returns the logical sum of the values. E.g., if Left button and Right button are pressed, returns 3 (=1 | 2). <a href="/en-US/docs/Web/API/MouseEvent">More info</a>.</td> - </tr> - <tr> - <td><code>mozPressure</code> {{readonlyInline}}</td> - <td>float</td> - <td>The amount of pressure applied to a touch or tabdevice when generating the event; this value ranges between 0.0 (minimum pressure) and 1.0 (maximum pressure).</td> - </tr> - <tr> - <td><code>ctrlKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the control key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>shiftKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the shift key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>altKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the alt key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - <tr> - <td><code>metaKey</code> {{readonlyInline}}</td> - <td>boolean</td> - <td><code>true</code> if the meta key was down when the event was fired. <code>false</code> otherwise.</td> - </tr> - </tbody> -</table> - -<h2 id="Exemple">Exemple</h2> - -<pre class="brush: html"><div class="dropzone"> - <div id="draggable" draggable="true" ondragstart="event.dataTransfer.setData('text/plain',null)"> +{{APIRef}} + +L'événement **dragenter** est déclenché lorsqu'un élément glissé ou une sélection de texte entre dans une cible de drop valide. + +## Informations générales + +- Interface + - : {{domxref("DragEvent")}} +- Propagation + - : Oui +- Annulable + - : Oui +- Cible + - : La sélection immédiate de l'utilisateur (l'élément présentement indiqué par l'utilisateur comme cible pour le drop), ou l'élément {{HTMLElement("body")}}. +- Action par défaut + - : Rejette la sélection immédiate de l'utilisateur comme élément cible potentiel + +## Properties + +| Property | Type | Description | +| ---------------------------------------- | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `target` {{readonlyInline}} | [`EventTarget`](/en-US/docs/Web/API/EventTarget) | The element that was underneath the element being dragged. | +| `type` {{readonlyInline}} | [`DOMString`](/en-US/docs/Web/API/DOMString) | The type of event. | +| `bubbles` {{readonlyInline}} | [`Boolean`](/en-US/docs/Web/API/Boolean) | Whether the event normally bubbles or not | +| `cancelable` {{readonlyInline}} | [`Boolean`](/en-US/docs/Web/API/Boolean) | Whether the event is cancellable or not? | +| `view` {{readonlyInline}} | [`WindowProxy`](/en-US/docs/Web/API/WindowProxy) | [`document.defaultView`](/en-US/docs/Web/API/Document/defaultView) (`window` of the document) | +| `detail` {{readonlyInline}} | `long` (`float`) | 0. | +| `dataTransfer` | DataTransfer | The data that underlies a drag-and-drop operation, known as the [drag data store](/en-US/docs/Web/API/DataTransfer). Protected mode. | +| `currentTarget` {{readonlyInline}} | EventTarget | The node that had the event listener attached. | +| `relatedTarget` {{readonlyInline}} | EventTarget | For `mouseover`, `mouseout`, `mouseenter` and `mouseleave` events: the target of the complementary event (the `mouseleave` target in the case of a `mouseenter` event). `null` otherwise. | +| `screenX` {{readonlyInline}} | long | The X coordinate of the mouse pointer in global (screen) coordinates. | +| `screenY` {{readonlyInline}} | long | The Y coordinate of the mouse pointer in global (screen) coordinates. | +| `clientX` {{readonlyInline}} | long | The X coordinate of the mouse pointer in local (DOM content) coordinates. | +| `clientY` {{readonlyInline}} | long | The Y coordinate of the mouse pointer in local (DOM content) coordinates. | +| `button` {{readonlyInline}} | unsigned short | The button number that was pressed when the mouse event was fired: Left button=0, middle button=1 (if present), right button=2. For mice configured for left handed use in which the button actions are reversed the values are instead read from right to left. | +| `buttons` {{readonlyInline}} | unsigned short | The buttons being pressed when the mouse event was fired: Left button=1, Right button=2, Middle (wheel) button=4, 4th button (typically, "Browser Back" button)=8, 5th button (typically, "Browser Forward" button)=16. If two or more buttons are pressed, returns the logical sum of the values. E.g., if Left button and Right button are pressed, returns 3 (=1 \| 2). [More info](/en-US/docs/Web/API/MouseEvent). | +| `mozPressure` {{readonlyInline}} | float | The amount of pressure applied to a touch or tabdevice when generating the event; this value ranges between 0.0 (minimum pressure) and 1.0 (maximum pressure). | +| `ctrlKey` {{readonlyInline}} | boolean | `true` if the control key was down when the event was fired. `false` otherwise. | +| `shiftKey` {{readonlyInline}} | boolean | `true` if the shift key was down when the event was fired. `false` otherwise. | +| `altKey` {{readonlyInline}} | boolean | `true` if the alt key was down when the event was fired. `false` otherwise. | +| `metaKey` {{readonlyInline}} | boolean | `true` if the meta key was down when the event was fired. `false` otherwise. | + +## Exemple + +```html +<div class="dropzone"> + <div id="draggable" draggable="true" ondragstart="event.dataTransfer.setData('text/plain',null)"> This div is draggable - </div> -</div> -<div class="dropzone"></div> -<div class="dropzone"></div> -<div class="dropzone"></div> + </div> +</div> +<div class="dropzone"></div> +<div class="dropzone"></div> +<div class="dropzone"></div> -<style> +<style> #draggable { width: 200px; height: 20px; @@ -162,9 +72,9 @@ translation_of: Web/API/Document/dragenter_event margin-bottom: 10px; padding: 10px; } -</style> +</style> -<script> +<script> var dragged; /* Les événements sont déclenchés sur les objets glissables */ @@ -199,7 +109,7 @@ translation_of: Web/API/Document/dragenter_event }, false); document.addEventListener("dragleave", function( event ) { - // reset de l'arrière-plan des potentielles cible du drop lorsque les éléments glissables les quittent + // reset de l'arrière-plan des potentielles cible du drop lorsque les éléments glissables les quittent if ( event.target.className == "dropzone" ) { event.target.style.background = ""; } @@ -217,44 +127,27 @@ translation_of: Web/API/Document/dragenter_event } }, false); -</script> -</pre> +</script> +``` -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName("HTML WHATWG", "interaction.html#dndevents", "dragenter")}}</td> - <td>{{Spec2("HTML WHATWG")}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName("HTML5.1", "editing.html#dndevents", "dragenter")}}</td> - <td>{{Spec2("HTML5.1")}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------- | -------------------------------- | ------------------- | +| {{SpecName("HTML WHATWG", "interaction.html#dndevents", "dragenter")}} | {{Spec2("HTML WHATWG")}} | | +| {{SpecName("HTML5.1", "editing.html#dndevents", "dragenter")}} | {{Spec2("HTML5.1")}} | Définition initiale | -<h2 id="Compatiblités_navigateurs">Compatiblités navigateurs</h2> +## Compatiblités navigateurs -<p>{{Compat("api.Document.dragenter_event")}}</p> +{{Compat("api.Document.dragenter_event")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{event("drag")}}</li> - <li>{{event("dragstart")}}</li> - <li>{{event("dragend")}}</li> - <li>{{event("dragover")}}</li> - <li>{{event("dragenter")}}</li> - <li>{{event("dragleave")}}</li> - <li>{{event("dragexit")}}</li> - <li>{{event("drop")}}</li> -</ul> +- {{event("drag")}} +- {{event("dragstart")}} +- {{event("dragend")}} +- {{event("dragover")}} +- {{event("dragenter")}} +- {{event("dragleave")}} +- {{event("dragexit")}} +- {{event("drop")}} |