The copy event is fired when the user initiates a copy action through the browser UI (for example, using the CTRL/Cmd+C keyboard shortcut or selecting the "Copy" from the menu) and in response to an allowed document.execCommand('copy') call.
General info
- Specification
- Clipboard
- Interface
ClipboardEvent- Bubbles
- Yes
- Cancelable
- Yes
- Target
Element: the focused element (forcontentEditableelements - the element containing the start of the selection), or the<body>element.- Default Action
- See below.
A handler for this event can modify the provided ClipboardEvent.clipboardData object by calling 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
});
A handler for this event cannot read the clipboard data using clipboardData.getData().
The event's default action depends on the source of the event and the handler's behavior:
- A synthetic copy event does not have a default action; otherwise
- If the event was not cancelled: copies the selection (if any) to the clipboard;
- If a handler cancelled the event and called
setData(): copies the contents ofclipboardDatato the clipboard; - If a handler cancelled the event without calling
setData(): no action.
Properties
| Property | Type | Description |
|---|---|---|
target Read only |
EventTarget |
The event target (the topmost target in the DOM tree). |
type Read only |
DOMString |
The type of event. |
bubbles Read only |
Boolean |
Whether the event normally bubbles or not |
cancelable Read only |
Boolean |
Whether the event is cancellable or not? |
Browser compatibility
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| Basic support | (Yes) | (Yes) | ? | ? | ? |
clipboardData |
(Yes) | 22 (22) | No support | ? | ? |
| Feature | Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| Basic support | ? | (Yes) | ? | ? | ? |
clipboardData |
? | 22.0 (22) | ? | ? | ? |