Clipboard
Baseline
Large disponibilité
*
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis mars 2020.
* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.
Contexte sécurisé: Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.
L'interface Clipboard implémente l'API clipboard, qui fournit — si l'utilisateur ou l'utilisatrice accorde sa permission — un accès en lecture et en écriture au contenu du presse-papiers du système. L'API clipboard peut être utilisée pour implémenter les fonctionnalités couper, copier et coller dans une application web.
Le presse-papiers du système est exposé via la propriété globale Navigator.clipboard.
Les appels aux méthodes de l'objet Clipboard échoueront si l'utilisateur ou l'utilisatrice n'a pas accordé les permissions requises en utilisant l'API permissions, et la permission "clipboard-read" ou "clipboard-write" selon le besoin.
Toutes les méthodes de l'API clipboard fonctionnent de manière asynchrone ; elles renvoient une Promise qui est résolue une fois que l'accès au presse-papiers a réussi. La promesse est rejetée si l'accès au presse-papiers est refusé.
Méthodes d'instance
Clipboard est basé sur l'interface EventTarget, et inclut les méthodes de celle-ci.
read()-
Demande des données arbitraires (telles que des images) depuis le presse-papiers, et renvoie une
Promise. Quand les données ont été obtenues, la promesse est résolue avec un objetDataTransferqui fournit les données. readText()-
Demande du texte depuis le presse-papiers du système ; renvoie une
Promisequi est résolue avec uneStringcontenant le texte du presse-papiers une fois disponible. write()-
Écrit des données arbitraires dans le presse-papiers du système. Cette opération asynchrone signale quand elle a terminé en résolvant la
Promiserenvoyée. writeText()-
Écrit du texte dans le presse-papiers du système, renvoyant une
Promisequi est résolue une fois que le texte est entièrement copié dans le presse-papiers.
Évènements
clipboardchange-
Déclenché lorsque le contenu du presse-papiers du système est modifié de quelque manière que ce soit, par exemple par une commande de copie du système, ou avec une méthode API telle que
Clipboard.writeText().
Spécifications
| Spécification |
|---|
| Clipboard API and events # clipboard-interface |
Compatibilité des navigateurs
Voir aussi
- La méthode
Document.execCommand()