We're looking for a user researcher to understand the needs of developers and designers. Is this you or someone you know? Check out the post: https://mzl.la/2IGzdXS

L'événement copy est déclenché lorsque l'utilisateur initie une copie par le biais de l'interface du navigateur (par exemple, Ctrl/Cmd+C ou "copier" du menu contextuel) et en réponse d'un appel de document.execCommand('copy') autorisé.

Informations générales

Spécification
Clipboard
Interface
ClipboardEvent
Propagation
Oui
Annulable
Oui
Cible
Element: L'élément ayant le focus (pour les éléments contentEditable - l'élément contenant le début de la sélection), ou l'élément <body>
Action par défaut
Voir ce-dessous

Un gestionnaire de cet événement peut modifier l'objet ClipboardEvent.clipboardData en appellant setData(format, data):

document.addEventListener('copy', function(e){
    e.clipboardData.setData('text/plain', 'Hello, world!');
    e.clipboardData.setData('text/html', '<b>Hello, world!</b>');
    e.preventDefault(); // We want our data, not data from any selection, to be written to the clipboard
});

Un gestionnaire de cet événement ne peut pas lire les données du presse-papiers en utilisant clipboardData.getData().

L'action par défaut de l'événement dépend de la source de celui-ci et du comportement du gestionnaire:

  • Un événement de copie synthétique n'a pas d'action par défaut;
  • Si l'événement n'a pas été annulé: Copie de la sélection (s'il y a) dans le presse-papiers;
  • Si le gestionnaire a annulé l'événement et appelé setData(): Copie le contenu de clipboardData de ClipboardEvent;
  • Si le gestionnaire a annulé l'événement sans appelé setData(): Aucune action.

Propriétés

Property Type Description
target Lecture seule EventTarget The event target (the topmost target in the DOM tree).
type Lecture seule DOMString The type of event.
bubbles Lecture seule Boolean Whether the event normally bubbles or not.
cancelable Lecture seule Boolean Whether the event is cancellable or not.

Compatibilités navigateur

Nous convertissons les données de compatibilité dans un format JSON. Ce tableau de compatibilité utilise encore l'ancien format car nous n'avons pas encore converti les données qu'il contient. Vous pouvez nous aider en contribuant !

Navigateur Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Support basique (Oui) (Oui) ? ? ?
clipboardData (Oui) 22 (22) Pas de support ? ?
Navigateur Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Support basique ? (Oui) ? ? ?
clipboardData ? 22.0 (22) ? ? ?

Evénements liés

Étiquettes et contributeurs liés au document

Contributeurs à cette page : fscholz, Kalwyn
Dernière mise à jour par : fscholz,