Clipboard.write()
Baseline
2024
Newly available
Depuis June 2024, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.
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
DataTransfercontenant 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.
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() 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
Chargement…