CKTIS / HTML
onpaste — obravnavalnik dogodka lepljenja
Atribut onpaste dodeli kodo JavaScript za obravnavo dogodka paste. Na voljo je pri vseh elementih HTML, vendar element zaradi dodanega atributa ne postane urejevalen.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
onpaste="JavaScript function body"onpaste je globalni atribut HTML za obravnavo dogodkov, povezan z dogodkom paste. Njegova vrednost vsebuje stavke JavaScript, ki sestavljajo telo funkcije, ne pa imena vrste dogodka. Sam atribut elementa ne naredi urejevalnega.
V kodi atributa je event objekt dogodka, this pa element, ki dogodek obravnava. return false prekliče privzeto dejanje dogodka, kadar ga je mogoče preklicati; pri običajnem lepljenju v urejevalno polje s tem prepreči vstavljanje besedila. Ne ustavi širjenja dogodka.
Atribut HTML onpaste in lastnost JavaScript element.onpaste nastavita isti mehanizem obravnave: atribut vsebuje kodo, lastnosti pa se dodeli funkcija ali null. Ponovna dodelitev lastnosti nadomesti prejšnjo funkcijo. addEventListener('paste', handler) poslušalce registrira ločeno; uporablja paste, brez predpone on.
Primer posodobi sporočilo o stanju in blokira privzeto lepljenje. Zahteva omogočen JavaScript in dovoljenje za izvajanje vstavljenih obravnavalnikov dogodkov; Content Security Policy jih lahko blokira. Te kode ne sestavljajte iz nezaupanja vrednih podatkov.
Primeri
<!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>Rezultat
paste handled
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.