dataTransferNN s.o. IE 5 (Win) DOM s.o.

L´objet dataTransfer (accessible en tant que propriété de l´objet event) est un conteneur temporaire que les scripts dans IE 5 et versions ultérieures pour Windows peuvent utiliser pour transférer des données de texte, en particulier pendant les opérations contrôlées par script simulant le découpage, la copie et le collage, ou contrôlant le glissement. Votre script contrôle quelles données sont stockées dans l´objet dataTransfer, comme par exemple, le texte seul d´un élément, la totalité du HTML d´un élément ou l´URL d´une image. Par exemple, une page destinée aux enfants peut afficher simplement des icônes de plusieurs espèces d´animaux différents. Si l´utilisateur commence à faire glisser l´icône du chien, le script déclenché par les gestionnaires d´événements ondragstart de l´élément img peut stocker une valeur d´attribut personnalisé de cet élément (par exemple l´URL d´une jolie photo de chien) dans l´objet dataTransfer. Lorsque l´utilisateur dépose l´icône dans la zone prévue à cet effet, la fonction du gestionnaire d´événements ondrop lit les données de l´objet dataTransfer et charge la photo à son emplacement sur la page.

 

Bien que les propriétés d´un objet élément changent à chaque nouvelle action d´événement, l´objet dataTransfer conserve ses données d´un élément à l´autre, jusqu´à ce qu´un script supprime ces données ou que d´autres données y soient stockées. Les propriétés de l´objet dataTransfer distinguent ces capacités de celles de l´objet clipboardData. En définissant les propriétés dropEffect et effectAllowed, vos scripts peuvent contrôler le type d´icône de curseur qui apparaît pendant les opérations de type glisser-déposer.

 

Pour plus d´informations sur le transfert des données avec cet objet et l´objet clipboardData, visitez http://msdn.microsoft.com/workshop/author/datatransfer/overview.asp.

 
Equivalent HTML

Aucune.
 
Référence de modèle d'objet
  
[window.]event.dataTransfer
 
Propriétés spécifiques à l´objet
 
dropEffecteffectAllowed
 
Méthodes spécifiques à l´objet
 
clearData()getData()setData()
 
Propriétés de gestionnaire d´événements spécifiques à l´objet

Aucune.

dropEffect, effectAllowedNN s.o. IE 5 DOM s.o.

Lecture/écriture

Ces deux propriétés fonctionnent ensemble mais à des étapes différentes d´une opération de glissement avec l´objet dataTransfer. Elles contrôlent toutes les deux l´apparence du curseur pendant le processus « glisser-déposer ». Affectez un style de curseur au début d´une opération de glissement avec l´événement ondragstart et la propriété effectAllowed. Les gestionnaires d´événements ondragover et ondragenter de la cible « déposer » devraient définir la propriété dropEffect sur le style de curseur désiré et aussi définir la propriété event.returnValue sur false. Cela ouvre la voie au gestionnaire d´événements ondrop non seulement pour définir le curseur avec la propriété dropEffect, mais aussi pour traiter l´action « déposer ».

 
Exemple
  
event.dataTransfer.dropEffect= "copy";
 
Valeur

Constante (sous forme de chaîne) non sensible à la casse: copy | link | move | none.

 
Par défaut

none
clearData()NN s.o. IE 5 (Win) DOM s.o.

clearData([dataFormat])

Supprime les données de l´objet dataTransfer.
 
Paramètres
 
  • Une chaîne facultative spécifiant le format pour les données à supprimer. Les projets précédents visant à autoriser plusieurs types de données semblent avoir été abandonnés. A partir de Microsoft Internet Explorer 6, Text est le seul format fiable. L´omission du paramètre supprime toutes les données de tous les types.
 
Valeur renvoyée

Aucune.
getData()NN s.o. IE 5 (Win) DOM s.o.

getData(dataFormat)

Renvoie une copie des données de l´objet dataTransfer. Le contenu de dataTransfer reste intact pour les lectures suivantes dans les autres instructions de script.

 
Paramètres
 
  • Une chaîne spécifiant le format pour les données à lire. Les projets précédents visant à autoriser plusieurs types de données semblent avoir été abandonnés. A partir de Microsoft Internet Explorer 6, Text est le seul format fiable.
 
Valeur renvoyée

Chaîne.
setData()NN s.o. IE 5 (Win) DOM s.o.

setData(dataFormat, stringData)

Stocke les données de chaîne dans l´objet dataTransfer. Renvoie la valeur booléenne true si l´affectation réussit

 
Paramètres
 
  • Une chaîne spécifiant le format pour les données à lire. Les projets précédents visant à autoriser plusieurs types de données semblent avoir été abandonnés. A partir de Microsoft Internet Explorer 6, Text est le seul format fiable. Bien que la méthode accepte URL comme format, la lecture d´une valeur d´ensemble dans ce format échoue.
  • Une valeur de chaîne quelconque, y compris les chaînes contenant des balises HTML.
 
Valeur renvoyée

Valeur booléenne: true | false.