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