Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

oncopy — gestore dell’evento di copia

L’attributo oncopy assegna codice JavaScript per gestire l’evento copy. Può comparire su qualsiasi elemento HTML per reagire a una copia, ad esempio aggiornando un messaggio nella pagina.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

oncopy="JavaScript statements"

oncopy è un attributo globale di gestione degli eventi per copy, l’evento associato alla copia. Il suo valore contiene istruzioni JavaScript, non un valore booleano né semplicemente il nome di una funzione. Nel codice dell’attributo, il parametro event fornisce l’oggetto evento.

È importante distinguere l’attributo HTML dalla proprietà JavaScript element.oncopy, a cui si assegna una funzione o null. Questa proprietà è disponibile anche sugli oggetti Document e Window. Una nuova assegnazione sostituisce la funzione precedente della proprietà; addEventListener('copy', handler) consente di registrare listener indipendenti.

Copiare il testo selezionato nel paragrafo dell’esempio non garantisce l’esecuzione del relativo gestore. Per una selezione in un’area non modificabile, la specifica della Clipboard API indica come destinazione dell’evento copy il nodo che ha il focus, oppure body se nessun nodo ha il focus. Il paragrafo dell’esempio non può ricevere il focus. Se il suo gestore viene eseguito, il messaggio cambia in copy; altrimenti rimane Waiting. L’esempio non modifica il contenuto copiato. Se il gestore restituisce false, l’evento viene annullato se è annullabile. La Content Security Policy può bloccare il codice negli attributi; aggiungere oncopy non aggira questa restrizione.

Esempi

<!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>

Risultato

copy

Il risultato `copy` è stato osservato in un ambiente Chromium isolato. In altri browser il messaggio può rimanere `Waiting`.

Fonti