CKTIS / HTML
onpaste — obsluha události vložení
Atribut onpaste přiřazuje JavaScriptový kód pro obsluhu události paste. Je dostupný u všech prvků HTML, ale jeho přidáním se prvek nestane editovatelným.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
onpaste="JavaScript function body"onpaste je globální atribut HTML pro obsluhu událostí spojený s událostí paste. Jeho hodnota obsahuje příkazy JavaScriptu tvořící tělo funkce, nikoli název typu události. Samotný atribut prvek neučiní editovatelným.
V kódu atributu je event objekt události a this prvek, který událost obsluhuje. return false zruší výchozí akci události, pokud ji lze zrušit; při běžném vložení do editovatelného pole tím zabrání vložení textu. Nezastaví šíření události.
Atribut HTML onpaste a vlastnost JavaScriptu element.onpaste nastavují stejný mechanismus obsluhy: atribut obsahuje kód, zatímco vlastnosti se přiřazuje funkce nebo null. Další přiřazení vlastnosti nahradí předchozí funkci. addEventListener('paste', handler) registruje posluchače samostatně; používá paste, bez předpony on.
Příklad aktualizuje stavovou zprávu a blokuje výchozí vložení. Vyžaduje zapnutý JavaScript a povolené inline obslužné rutiny událostí; Content Security Policy je může blokovat. Tento kód nevytvářejte z nedůvěryhodných dat.
Příklady
<!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>Výsledek
paste handled
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.