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
- Interface
ClipboardEvent
- Propagation
-
Oui
- Annulable
-
Oui
- Cible
-
Element
: L'élément ayant le focus (pour les élémentscontentEditable
- 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. |