diff options
Diffstat (limited to 'files/fr/archive/mozilla/drag_and_drop/index.html')
| -rw-r--r-- | files/fr/archive/mozilla/drag_and_drop/index.html | 118 |
1 files changed, 118 insertions, 0 deletions
diff --git a/files/fr/archive/mozilla/drag_and_drop/index.html b/files/fr/archive/mozilla/drag_and_drop/index.html new file mode 100644 index 0000000000..bfe2d51f0e --- /dev/null +++ b/files/fr/archive/mozilla/drag_and_drop/index.html @@ -0,0 +1,118 @@ +--- +title: Drag and Drop +slug: Archive/Mozilla/Drag_and_drop +tags: + - TopicStub + - XUL +translation_of: Archive/Mozilla/Drag_and_drop +--- +<p>{{ Next("Drag and Drop JavaScript Wrapper") }}</p> + +<p>{{ deprecated_header("gecko1.9.1") }}</p> + +<div class="warning">Depuis Gecko 1.9.1 (Firefox 3.5), ces API sont officiellement obsolètes, <a href="/En/DragDrop/Drag_and_Drop" title="en/DragDrop/Drag and Drop">les API portables plus récentes et plus simple</a> doivent être utilisées à leur place.</div> + +<p>Cette section décrit comment implémenter des objets qui peuvent être glissés et déposés sur d'autres objets.</p> + +<h3 id="The_Drag_and_Drop_Interface" name="The_Drag_and_Drop_Interface">L'interface glisser-déposer</h3> + +<p>De nombreuses interfaces utilisateur permettent de faire glisser des objets particuliers dans l'interface. Par exemple, faire glisser des fichiers vers d'autres répertoires ou faire glisser une icône vers une autre fenêtre pour ouvrir le document auquel elle fait référence. Mozilla et <a href="/en/XUL" title="en/XUL">XUL</a> fournissent un certain nombre d'événements qui peuvent gérer lorsque l'utilisateur tente de faire glisser des objets.</p> + +<p>Un utilisateur peut commencer à faire glisser en maintenant le bouton de la souris enfoncé et en déplaçant la souris. Le glissement s'arrête lorsque l'utilisateur relâche la souris. Les gestionnaires d'événements sont appelés lorsque l'utilisateur démarre et termine le glissement, et à divers points intermédiaires.</p> + +<p>Mozilla implémente le glissement en utilisant une session de glissement. Lorsqu'un utilisateur demande à faire glisser quelque chose qui peut être glissé, une session de glissement doit être lancée. La session de glissement gère la mise à jour du curseur de la souris et l'emplacement où l'objet doit être déposé. Si quelque chose ne peut pas être glissé, il ne doit pas démarrer une session de glisser. Étant donné que l'utilisateur n'a généralement qu'une seule souris, une seule session de glissement est en cours d'utilisation à la fois.</p> + +<p>Notez que les sessions de glissement peuvent être créées depuis Mozilla lui-même ou depuis d'autres applications. Mozilla traduira les données glissées selon les besoins.</p> + +<p>La liste ci-dessous décrit les gestionnaires d'événements qui peuvent être appelés, qui peuvent être placés sur n'importe quel élément. Il vous suffit de mettre des valeurs pour les gestionnaires là où vous devez faire quelque chose lorsque l'événement se produit.</p> + +<dl> + <dt>ondrag {{ Fx_minversion_inline(3) }}</dt> + <dd>Appelé périodiquement tout au long de l'opération de glisser-déposer.</dd> + <dt>ondraggesture </dt> + <dd>Appelé lorsque l'utilisateur commence à faire glisser l'élément, ce qui se produit normalement lorsque l'utilisateur maintient le bouton de la souris enfoncé et déplace la souris. Le script de ce gestionnaire doit configurer une session de glissement.</dd> + <dt>ondragstart {{ Fx_minversion_inline(3) }} </dt> + <dd>Un alias pour <code>ondraggesture</code>; il s'agit du nom de spécification HTML 5 de l'événement et peut être utilisé en HTML ou XUL; cependant, pour une compatibilité descendante avec les anciennes versions de Firefox, vous souhaiterez peut-être continuer à utiliser <code>ondraggesture</code> dans XUL.</dd> + <dt>ondragover </dt> + <dd>Ce gestionnaire d'événements est appelé pour un élément lorsque quelque chose est glissé dessus. Si l'objet peut être déposé sur l'élément, la session de glissement doit être notifiée.</dd> + <dt>ondragenter </dt> + <dd>Appelé pour un élément lorsque le pointeur de la souris passe pour la première fois sur l'élément pendant que quelque chose est déplacé. Cela peut être utilisé pour modifier l'apparence de l'élément pour indiquer à l'utilisateur que l'objet peut être déposé dessus.</dd> + <dt>ondragexit </dt> + <dd>Appelé pour un élément lorsque le pointeur de la souris sort d'un élément pendant que quelque chose est déplacé. Il est également <span class="tlid-translation translation" lang="fr"><span title="">appelé une fois qu'une suppression est terminée afin qu'un élément ait une chance de supprimer toute mise en évidence ou autre indication.</span></span></dd> + <dt>ondragdrop </dt> + <dd>Ce gestionnaire d'événements est appelé pour un élément lorsque quelque chose est déposé sur l'élément. À ce stade, l'utilisateur a déjà relâché le bouton de la souris. L'élément peut simplement ignorer l'événement ou le gérer d'une manière ou d'une autre, par exemple en collant l'objet glissé sur lui-même.</dd> + <dt>ondragend {{ Fx_minversion_inline(3) }} </dt> + <dd>Appelé lorsque l'opération de glissement est terminée.</dd> +</dl> + +<p>Il existe deux façons de gérer les événements par glisser-déposer. Cela consiste d'abord à utiliser directement les interfaces <a href="/en/XPCOM" title="en/XPCOM">XPCOM</a> glisser-déposer. La seconde consiste à utiliser un objet <a href="/en/Drag_and_Drop_JavaScript_Wrapper" title="en/Drag_and_Drop_JavaScript_Wrapper">wrapper JavaScript</a> qui gère une partie de cela pour vous. Le code de ce wrapper se trouve dans un fichier nommé {{ Source("toolkit/content/nsDragAndDrop.js nsDragAndDrop.js") }} qui est contenu dans le package widget-toolkit (ou global).</p> + +<h3 id="XPCOM_Drag_and_Drop_interfaces" name="XPCOM_Drag_and_Drop_interfaces">Interfaces XPCOM Glisser-déposer</h3> + +<p>Deux interfaces sont utilisées pour prendre en charge le glisser-déposer. Le premier est un service de glissement, <a href="/en/XPCOM_Interface_Reference/nsIDragService" title="en/nsIDragService">nsIDragService</a> et le second est la session de glissement, <a href="/en/XPCOM_Interface_Reference/nsIDragSession" title="en/nsIDragSession">nsIDragSession</a>.</p> + +<p>Le <a href="/en/XPCOM_Interface_Reference/nsIDragService" title="en/nsIDragService">nsIDragService</a> est responsable de la création de sessions de glissement lorsqu'un glissement démarre et de la suppression de la session de glissement lorsque le glissement est terminé. La fonction <code>invokeDragSession</code> doit être appelée pour démarrer un glissement dans un gestionnaire d'événements <code>ondraggesture</code>. Une fois cette fonction appelée, un glissement a commencé.</p> + +<p>La fonction invokeDragSession prend quatre paramètres, comme décrit ci-dessous:</p> + +<pre class="eval notranslate">invokeDragSession(element,transferableArray,region,actions) +</pre> + +<dl> + <dt>element </dt> + <dd>Une référence à l'élément qui est déplacé. Cela peut être récupéré en obtenant la propriété <code>event.target</code> pendant le gestionnaire d'événements.</dd> + <dt>transferableArray </dt> + <dd>Un tableau d'objets <a href="/en/NsITransferable" title="en/NsITransferable">nsITransferable</a>, un pour chaque élément glissé. <span class="tlid-translation translation" lang="fr"><span title="">Un tableau est utilisé car vous souhaiterez peut-être faire glisser plusieurs objets à la fois, comme un ensemble de fichiers.</span></span></dd> + <dt>region </dt> + <dd>Une région utilisée pour l'indication de rétroaction. Cela devrait généralement être défini sur null.</dd> + <dt>actions </dt> + <dd>Les actions utilisées par le glissement. Cela doit être défini sur l'une des constantes suivantes, ou sur plusieurs ajoutées. L'action peut être modifiée pendant le glissement en fonction de ce qui est glissé.</dd> +</dl> + +<dl> + <dt>nsIDragService.DRAGDROP_ACTION_NONE </dt> + <dd> + <dl> + <dt>Utilisé pour indiquer qu'aucun glissement n'est valide.</dt> + <dt>nsIDragService.DRAGDROP_ACTION_COPY </dt> + <dd>L'élément déplacé doit être copié vers son emplacement de dépôt.</dd> + <dt>nsIDragService.DRAGDROP_ACTION_MOVE </dt> + <dd>L'élément déplacé doit être déplacé vers son emplacement de dépôt.</dd> + <dt>nsIDragService.DRAGDROP_ACTION_LINK </dt> + <dd>Un lien (ou un raccourci ou un alias) vers l'élément en cours de glissement doit être créé à l'emplacement de dépôt.</dd> + </dl> + </dd> +</dl> + +<p>L'interface {{ interface("nsIDragService") }} fournit également la fonction <code>getCurrentSession</code> qui peut être appelée depuis les gestionnaires d'événements de glissement pour obtenir et modifier l'état du glissement. La fonction renvoie un objet qui implémente {{interface ("nsIDragSession")}}.</p> + +<p>L'interface <a href="/en/XPCOM_Interface_Reference/nsIDragSession" title="en/nsIDragSession">nsIDragSession</a> est utilisée pour obtenir et définir les propriétés du glissement en cours. Les propriétés et méthodes suivantes sont disponibles:</p> + +<dl> + <dt>canDrop </dt> + <dd>Définissez cette propriété sur <code>true</code> si l'élément sur lequel se trouve actuellement la souris peut accepter que l'objet actuellement glissé soit déposé dessus. Définissez la valeur sur <code>false</code> si cela n'a pas de sens d'y déposer l'objet. Cela doit être modifié dans les gestionnaires d'événements <code>ondragover</code> et <code>ondragenter</code>.</dd> + <dt>dragAction </dt> + <dd>Défini sur l'action en cours à effectuer, qui doit être une ou plusieurs des constantes décrites précédemment. Cela peut être utilisé pour fournir des commentaires supplémentaires à l'utilisateur.</dd> + <dt>numDropItems </dt> + <dd>Le nombre d'éléments glissés. Par exemple, il sera défini sur 5 si cinq signets sont déplacés.</dd> + <dt>getData(transfer,index) </dt> + <dd>Récupérez les données glissées. Le premier argument doit être un objet <a href="/en/NsITransferable" title="en/NsITransferable">nsITransferable</a> pour contenir les données. Le deuxième argument, <code>index</code>, doit être l'index de l'élément à renvoyer.</dd> + <dt>sourceDocument </dt> + <dd>Le document où le glissement a commencé</dd> + <dt>sourceNode </dt> + <dd>Le <span class="tlid-translation translation" lang="fr"><span title="">nœud</span></span> <a href="/en/DOM" title="en/DOM">DOM</a> où le glissement a commencé.</dd> + <dt>isDataFlavorSupported(flavor) </dt> + <dd>Renvoie <code>true</code> si les données déplacées contiennent des données de la saveur spécifiée.</dd> +</dl> + +<p>{{ Next("Drag and Drop JavaScript Wrapper") }}</p> + +<div class="originaldocinfo"> +<h2 id="Original_Document_Information" name="Original_Document_Information">Informations sur le Document Original</h2> + +<ul> + <li>Auteur(s): <a class="link-mailto" href="mailto:enndeakin@sympatico.ca">Neil Deakin</a></li> + <li>Document original:</li> + <li>Information sur les droits d'auteur: Copyright (C) <a class="link-mailto" href="mailto:enndeakin@sympatico.ca">Neil Deakin</a></li> +</ul> +</div> |