Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

oncopy — obsługa zdarzenia kopiowania

Atrybut oncopy przypisuje kod JavaScript obsługujący zdarzenie copy. Można go umieścić na dowolnym elemencie HTML, aby reagować na kopiowanie, na przykład aktualizując komunikat na stronie.

Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately

Składnia

oncopy="JavaScript statements"

oncopy jest globalnym atrybutem obsługi zdarzenia copy, związanego z kopiowaniem. Jego wartość zawiera instrukcje JavaScript, a nie wartość logiczną ani samą nazwę funkcji. W kodzie atrybutu parametr event udostępnia obiekt zdarzenia.

Odróżniaj atrybut HTML od właściwości JavaScript element.oncopy, której przypisuje się funkcję lub null. Właściwość ta jest dostępna również na obiektach Document i Window. Kolejne przypisanie zastępuje poprzednią funkcję tej właściwości; addEventListener('copy', handler) pozwala rejestrować niezależne nasłuchy.

Kopiowanie tekstu zaznaczonego w akapicie z przykładu nie gwarantuje uruchomienia jego kodu obsługi. Zgodnie ze specyfikacją Clipboard API przy kopiowaniu zaznaczenia spoza obszaru edytowalnego zdarzenie copy jest kierowane do węzła, który ma fokus, a jeśli żaden węzeł nie ma fokusu — do elementu body. Akapit z przykładu nie może otrzymać fokusu. Jeśli jego kod obsługi się wykona, komunikat zmieni się na copy; w przeciwnym razie pozostanie Waiting. Przykład nie zmienia kopiowanej treści. Zwrócenie false z obsługi anuluje zdarzenie, jeśli można je anulować. Polityka Content Security Policy może blokować kod w atrybutach; samo dodanie oncopy nie omija tego ograniczenia.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>oncopy demo</title>
<p id="sample" oncopy="document.getElementById('status').textContent = event.type">Select and copy this text.</p>
<output id="status">Waiting</output>
</html>

Wynik

copy

W odizolowanym środowisku Chromium uzyskano wynik `copy`. W innych przeglądarkach komunikat może pozostać `Waiting`.

Źródła