copy

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 (en-US)
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-US) en appellant setData(format, data) (en-US):

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() (en-US).

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 (en-US);
  • 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.

Spécifications

Spécification Statut
Clipboard API and events Version de travail

Compatibilités navigateur

BCD tables only load in the browser

Voir aussi