ondragÉvénement

事件对象参考手册Objet Event

Exemple

Exécuter JavaScript lorsque l'élément <p> commence à être glissé :

<p draggable="true" ondrag="myFunction(event)">Glissez-moi !</p>

Essayez-le vous-même »

D'autres exemples sont inclus en bas de cet article.


Définition et utilisation

L'événement ondrag est déclenché lorsqu'un élément ou un texte sélectionné est en cours de glissement.

Le glisser-déposer est une fonctionnalité très courante dans HTML5. Pour plus d'informations, consultez notre tutoriel HTML surGlisser-déposer HTML5。

Remarque :Pour rendre un élément déplaçable, vous devez utiliser l'attribut HTML5draggable.

Astuce :Les liens et les images sont déplaçables par défaut, et n'ont pas besoin de l'attribut draggable.

Les événements suivants sont déclenchés pendant le processus de glisser-déposer :

  • Événements déclenchés sur la cible de glissement(élément source):
    • ondragstart- Déclenché lorsque l'utilisateur commence à glisser un élément
    • ondrag - Déclenché pendant que l'élément est en cours de glissement
    • ondragend- Déclenché après que l'utilisateur a terminé de glisser l'élément

  • Événements déclenchés sur la cible de dépôt :
    • ondragenter- Cet événement est déclenché lorsqu'un objet glissé entre dans la zone de son conteneur
    • ondragover- Cet événement est déclenché lorsqu'un objet en cours de glissement est glissé dans la zone du conteneur d'un autre objet
    • ondragleave- Cet événement est déclenché lorsqu'un objet glissé quitte la zone de son conteneur
    • ondrop- Cet événement est déclenché lorsque le bouton de la souris est relâché pendant un glissement

Remarque :L'événement ondrag est déclenché toutes les 350 millisecondes pendant qu'un élément est glissé.


Prise en charge des navigateurs

Les nombres dans le tableau indiquent la première version du navigateur qui prend entièrement en charge l'événement.

Événement
ondrag 4.0 9.0 3.5 6.0 12.0


Syntaxe

En HTML :

<element ondrag="myScript">Essayez-le vous-même

En JavaScript :

object.ondrag=function(){myScript};Essayez-le vous-même

En JavaScript, en utilisant la méthode addEventListener() :

object.addEventListener("drag", myScript);Essayez-le vous-même

Remarque :Internet Explorer 8 et les versions IE antérieures ne prennent pas en charge la méthodeaddEventListener().


Détails techniques
Bulles : Oui
Annulable : Oui
Type d'événement : DragEvent
Balises HTML prises en charge : Tous les éléments HTML


Examples

Plus d’exemples

Exemple

L'exemple suivant démontre tous les événements de glisser-déposer :

/* Déclenché lors du glissement */
document.addEventListener("dragstart", function(event) {
// La méthode dataTransfer.setData() définit le type de données et les données glissées
    event.dataTransfer.setData("Text", event.target.id);
// Afficher un texte lorsque l'élément p est glissé
document.getElementById("demo").innerHTML = "Commencez à faire glisser l'élément p.";
// Modifier l'opacité de l'élément glissé
    event.target.style.opacity = "0.4";
});
// Pendant le glissement de l'élément p, modifier la couleur du texte de sortie
document.addEventListener("drag", function(event) {
    document.getElementById("demo").style.color = "red";
});
// Une fois le glissement de l'élément p terminé, afficher un texte et réinitialiser l'opacité
document.addEventListener("dragend", function(event) {
document.getElementById("demo").innerHTML = "Glissement de l'élément p terminé";
    event.target.style.opacity = "1";
});
/* Déclenché après la fin du glissement */
// Lorsque l'élément p est glissé dans le droptarget, modifier le style de bordure de la div
document.addEventListener("dragenter", function(event) {
    if ( event.target.className == "droptarget" ) {
        event.target.style.border = "3px dotted red";
    }
});
// Par défaut, les données/éléments ne peuvent pas être déposés dans d'autres éléments. Pour le dépôt, nous devons empêcher la gestion par défaut de l'élément
document.addEventListener("dragover", function(event) {
    event.preventDefault();
});
// Lorsque l'élément p déplaçable quitte le droptarget, réinitialiser le style de bordure de la div
document.addEventListener("dragleave", function(event) {
    if ( event.target.className == "droptarget" ) {
        event.target.style.border = "";
    }
});
/* Pour drop, empêcher la gestion par défaut des données par le navigateur (les liens sont ouverts par défaut lors d'un drop)
Réinitialiser la couleur du texte de sortie et la couleur de bordure du DIV
Utiliser la méthode dataTransfer.getData() pour obtenir les données glissées
L'id de l'élément de données glissé ("drag1")
Ajouter l'élément glissé à l'élément de dépôt*/
document.addEventListener("drop", function(event) {
    event.preventDefault();
    if ( event.target.className == "droptarget" ) {
        document.getElementById("demo").style.color = "";
        event.target.style.border = "";
        var data = event.dataTransfer.getData("Text");
        event.target.appendChild(document.getElementById(data));
    }
});

Essayez-le vous-même »


Pages associées

Tutoriel HTML :Glisser-déposer HTML5

Manuel de référence HTML :Attribut draggable HTML


事件对象参考手册Objet Event Autres extensions