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

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.

Compatibilité des navigateurs

BCD tables only load in the browser