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

L´objet clipboardData (accessible en tant que propriété de l´objet window ou frame) 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 clipboardData, qu´il s´agisse seulement du texte d´un élément, de la totalité du HTML d´un élément ou de 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 le gestionnaire d´événements onDragStart de l´élément img stocke une valeur d´attribut personnalisé de cet élément (par exemple l´URL d´une photo de chien) dans l´objet clipboardData. 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 clipboardData et charge la photo à son emplacement sur la page.

 

Les données stockées dans cet objet sont conservées même en cas de navigation vers d´autres pages au sein des mêmes domaine et protocole. Ainsi, vous pouvez l´utiliser pour transmettre des données de texte (y compris des tableaux ayant été convertis en chaînes par la méthode Array.join()) d´une page à l´autre sans utiliser de cookies ni de chaînes location.search. Mais il ne s´agit pas du presse-papiers système (pour des raisons de sécurité).

 

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

 
Equivalent HTML

Aucune.
 
Référence de modèle d'objet
  
[window.]clipboardData
 
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 (Win) DOM s.o.

Lecture/écriture

Ces deux propriétés appartiennent à l´objet clipboardData qui les a héritées de l´objet dataTransfer, auquel elles s´appliquent véritablement. Ignorez ces propriétés pour l´objet clipboardData.

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

clearData([dataFormat])

Supprime les données de l´objet clipboardData.
 
Paramètres
 
  • Une chaîne facultative spécifiant un seul 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 clipboardData. Le contenu de clipboardData 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 clipboardData. Renvoie la valeur booléenne true si l´affectation a réussi

 
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.