Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje