MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

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

Propriété 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

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 : Kalwyn
 Dernière mise à jour par : Kalwyn,