Element: evento 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.

El evento copy (copiar) de la API del portapapeles se dispara cuando el usuario inicia la acción de copiar por medio de la interfaz del usuario del navegador.

Por defecto, la acción del evento es copiar la selección (si existe) al portapapeles.

Un manejador para este evento permite modificar el contenido del portapapeles al llamar a setData(format, data) en la propiedad ClipboardEvent.clipboardData del evento, y cancelar la acción por defecto del objecto utilizando event.preventDefault().

Sin embargo, el manejador no puede leer los datos del portapapeles.

Es posible construir y lanzar un evento copy sintético, pero esto no afectará al portapapeles del sistema.

La burbuja del evento, es cancelable y compuesta.

Sintaxis

Use el nombre del evento en métodos como addEventListener(), o establezca una propiedad de manejador de eventos.

js
addEventListener("copy", (event) => {});

oncopy = (event) => {};

Tipo de evento

Ejemplos

Ejemplo en vivo

HTML

html
<div class="source" contenteditable="true">Copie el texto de esta caja.</div>
<div class="target" contenteditable="true">Y péguelo en esta otra.</div>

JavaScript

js
const source = document.querySelector("div.source");

source.addEventListener("copy", (event) => {
  const selection = document.getSelection();
  event.clipboardData.setData("text/plain", selection.toString().toUpperCase());
  event.preventDefault();
});

Resultado

Especificaciones

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

Compatibilidad con navegadores

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
copy event

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Véase también