Element: copy event
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("Clipboard API")}}
The **copy** event of the Clipboard API fires when the user initiates a copy action through the browser's user interface.
The event's default action is to copy the selection (if any) to the clipboard.
A handler for this event can _modify_ the clipboard contents by calling {{domxref("DataTransfer.setData", "setData(format, data)")}} on the event's {{domxref("ClipboardEvent.clipboardData")}} property, and canceling the event's default action using {{domxref("Event/preventDefault", "event.preventDefault()")}}.
However, the handler cannot _read_ the clipboard data.
It's possible to construct and dispatch a synthetic copy event, but this will not affect the system clipboard.
This event bubbles up the DOM tree, eventually to {{domxref("Document")}} and {{domxref("Window")}}, is cancelable and is composed.
Syntax
Use the event name in {{domxref("EventTarget/addEventListener", "addEventListener()")}}:
addEventListener("copy", (event) => { })Alternatively, assign to the event handler property of the interface:
oncopy = (event) => { }Event type
A {{domxref("ClipboardEvent")}}. Inherits from {{domxref("Event")}}.
{{InheritanceDiagram("ClipboardEvent")}}
Examples
Live example
HTML
<div class="source" contenteditable="true">Copy text from this box.</div>
<div class="target" contenteditable="true">And paste it into this one.</div>JavaScript
const source = document.querySelector("div.source");
source.addEventListener("copy", (event) => {
const selection = document.getSelection();
event.clipboardData.setData("text/plain", selection.toString().toUpperCase());
event.preventDefault();
});Result
{{ EmbedLiveSample('Live_example', '100%', '120px') }}
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- {{domxref("Element/cut_event", "cut")}} event
- {{domxref("Element/paste_event", "paste")}} event