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 : Les API Presse-papiers (clipboard) asynchrones sont toujours en cours d'implémentation. Consultez le tableau de compatibilité et la section Disponibilité du presse-papiers sur la page Clipboard
pour plus d'informations.
Syntaxe
js
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 contenu du presse-papier par le texte spécifié en paramètre.
js
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.
Spécifications
Specification |
---|
Clipboard API and events # dom-clipboard-write |
Compatibilité des navigateurs
BCD tables only load in the browser