diff --git a/files/es/web/api/element/copy_event/index.md b/files/es/web/api/element/copy_event/index.md new file mode 100644 index 00000000000000..78afa6c4db82d2 --- /dev/null +++ b/files/es/web/api/element/copy_event/index.md @@ -0,0 +1,89 @@ +--- +title: "Element: evento copy" +short-title: copy +slug: Web/API/Element/copy_event +l10n: + sourceCommit: c20c12fab32381b983b4148d712fda227d34e2bd +--- + +{{APIRef}} + +El evento **`copy`** (copiar) de la [API del portapapeles](/es/docs/Web/API/Clipboard_API) 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 {{domxref("DataTransfer.setData", "setData(format, data)")}} en la propiedad {{domxref("ClipboardEvent.clipboardData")}} del evento, y cancelar la acción por defecto del objecto utilizando {{domxref("Event/preventDefault", "event.preventDefault()")}}. + +Sin embargo, el manejador no puede _leer_ los datos del portapapeles. + +Es posible construir y lanzar un evento `copy` [sintético](/es/docs/Web/Events/Creating_and_triggering_events), pero esto no afectará al portapapeles del sistema. + +La [burbuja](/es/docs/Learn/JavaScript/Building_blocks/Event_bubbling) del evento, es [cancelable](/es/docs/Web/API/Event/cancelable) y [compuesta](/es/docs/Web/API/Event/composed). + +## Sintaxis + +Use el nombre del evento en métodos como {{domxref("EventTarget.addEventListener", "addEventListener()")}}, o establezca una propiedad de manejador de eventos. + +```js +addEventListener("copy", (event) => {}); + +oncopy = (event) => {}; +``` + +## Tipo de evento + +Un {{domxref("ClipboardEvent")}}. Hereda de {{domxref("Event")}}. + +{{InheritanceDiagram("ClipboardEvent")}} + +## Ejemplos + +### Ejemplo en vivo + +#### HTML + +```html +