CKTIS / HTML
onpaste — obsługa zdarzenia wklejania
Atrybut onpaste przypisuje kod JavaScript do obsługi zdarzenia paste. Można go stosować we wszystkich elementach HTML, ale samo jego dodanie nie czyni elementu edytowalnym.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
onpaste="JavaScript function body"onpaste jest globalnym atrybutem obsługi zdarzeń HTML powiązanym ze zdarzeniem paste. Jego wartość zawiera instrukcje JavaScript stanowiące ciało funkcji, a nie nazwę typu zdarzenia. Sam atrybut nie zapewnia możliwości edycji elementu.
W kodzie atrybutu event oznacza obiekt zdarzenia, a this — element obsługujący zdarzenie. Zwrot return false anuluje domyślne działanie zdarzenia, jeśli można je anulować; przy zwykłym wklejaniu do pola edycyjnego blokuje wstawienie tekstu. Nie oznacza to zatrzymania propagacji zdarzenia.
Atrybut HTML onpaste i właściwość JavaScript element.onpaste konfigurują ten sam mechanizm obsługi: atrybut zawiera kod, a właściwości przypisuje się funkcję lub null. Kolejne przypisanie właściwości zastępuje poprzednią funkcję. addEventListener('paste', handler) jest oddzielnym sposobem rejestrowania słuchaczy; używa nazwy paste, bez prefiksu on.
Przykład aktualizuje komunikat i blokuje domyślne wklejenie. Wymaga włączonego JavaScript oraz zezwolenia na obsługę zdarzeń zapisaną w atrybutach; polityka Content Security Policy może ją blokować. Nie składaj takiego kodu z niezaufanych danych.
Przykłady
<!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>Wynik
paste handled
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.