Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła