Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

onpaste — gestore dell’evento di incolla

L’attributo onpaste assegna codice JavaScript per gestire l’evento paste. È disponibile su tutti gli elementi HTML, ma aggiungerlo non rende modificabile un elemento.

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

Sintassi

onpaste="JavaScript function body"

onpaste è un attributo globale HTML per la gestione degli eventi, associato all’evento paste. Il suo valore contiene istruzioni JavaScript che formano il corpo di una funzione, non il nome di un tipo di evento. L’attributo, da solo, non rende modificabile un elemento.

Nel codice dell’attributo, event è l’oggetto evento e this è l’elemento che gestisce l’evento. return false annulla l’azione predefinita dell’evento quando è annullabile; in un normale incolla in un campo modificabile, impedisce l’inserimento del testo. Non interrompe la propagazione dell’evento.

L’attributo HTML onpaste e la proprietà JavaScript element.onpaste configurano lo stesso meccanismo di gestione: l’attributo contiene codice, mentre alla proprietà si assegna una funzione o null. Una nuova assegnazione della proprietà sostituisce la funzione precedente. addEventListener('paste', handler) registra gli ascoltatori separatamente; usa paste, senza il prefisso on.

L’esempio aggiorna un messaggio di stato e blocca l’incolla predefinito. Richiede JavaScript attivo e l’autorizzazione a eseguire gestori di eventi inline; una Content Security Policy può bloccarli. Non generare questo codice a partire da dati non attendibili.

Esempi

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onpaste demo</title>
<label>Paste here: <textarea onpaste="document.getElementById('status').textContent = 'paste handled'; return false;"></textarea></label>
<p id="status" role="status">waiting</p>
</html>

Risultato

paste handled

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti