CKTIS / HTML
oncopy — controlador del evento de copia
El atributo oncopy asigna código JavaScript para gestionar el evento copy. Puede aparecer en cualquier elemento HTML para reaccionar a una copia, por ejemplo, actualizando un mensaje en la página.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
oncopy="JavaScript statements"oncopy es un atributo global de controlador de eventos para copy, el evento asociado a la copia. Su valor contiene instrucciones JavaScript, no un valor booleano ni simplemente el nombre de una función. En el código del atributo, el parámetro event proporciona el objeto del evento.
Hay que distinguir el atributo HTML de la propiedad JavaScript element.oncopy, a la que se asigna una función o null. Esta propiedad también está disponible en los objetos Document y Window. Una nueva asignación sustituye la función anterior de la propiedad; addEventListener('copy', handler) permite registrar escuchas independientes.
Copiar texto seleccionado en el párrafo del ejemplo no garantiza que se ejecute su controlador. Para una selección en una zona no editable, la especificación de la Clipboard API establece que el evento copy se dirige al nodo que tiene el foco, o a body si ningún nodo lo tiene. El párrafo del ejemplo no puede recibir el foco. Si se ejecuta su controlador, el mensaje cambia a copy; de lo contrario, sigue mostrando Waiting. El ejemplo no modifica el contenido copiado. Devolver false desde el controlador cancela el evento si este se puede cancelar. La Content Security Policy puede bloquear el código en los atributos; añadir oncopy no elude esa restricción.
Ejemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>oncopy demo</title>
<p id="sample" oncopy="document.getElementById('status').textContent = event.type">Select and copy this text.</p>
<output id="status">Waiting</output>
</html>Resultado
copy
El resultado `copy` se observó en un entorno aislado de Chromium. En otros navegadores, el mensaje puede seguir mostrando `Waiting`.