copy

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.

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):

js
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.

Spécifications

Specification
Clipboard API and events
# clipboard-event-copy
HTML Standard
# handler-oncopy

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi