Clipboard.write()
La methode write()
de Clipboard
écrie des données arbitraire, comme des images, vers le presse-papier. Elle peut être utilisé pour implémenter une fonctionalité de copier coller.
Avant de pouvoir écrire dans le presse-papier, vous devez utiliser Permissions API pour avoir l'autorisation "clipboard-write"
.
Note: Browser support for the asynchronous clipboard APIs is still in the process of being implemented. Be sure to check the compatibility table as well as Clipboard availability in Clipboard for more information.
Syntax
var promise = navigator.clipboard.write(dataTransfer)
Paramètres
dataTransfer
- Un objet
DataTransfer
contenant les données à écrire dans le presse-papier.
Return value
Une Promise
qui sera résolut quand les données seront écrite dans le presse papier. Cette promesse est rejetée si l'accés au presse-papier échoue.
Exemple
Cette fonction d'exemple remplace l'actuel contenut du presse-papier par le texte spécifié en paramètre.
function setClipboard(text) {
let data = new DataTransfer();
data.items.add(text, "text/plain");
navigator.clipboard.write(data).then(function() {
/* success */
}, function() {
/* failure */
});
}
Le code commence par la creation d'un nouveau objet DataTransfer
dans lequel le texte est placé pour être envoyé au presse-papier. DataTransferItemList.add()
(en-US) est appelé pour ajouté le texte àDataTransfer
, ensuite write()
est appelé, en spécifiant une function d'accomplissement et une fonction d'erreur.
Specifications
Specification | Status | Comment |
---|---|---|
Clipboard API and events La définition de 'write()' dans cette spécification. |
Version de travail | Initial definition. |
Browser compatibility
BCD tables only load in the browser