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`.