CKTIS / HTML
oncopy — obravnavalnik dogodka kopiranja
Atribut oncopy dodeli kodo JavaScript za obravnavo dogodka copy. Uporabite ga lahko na katerem koli elementu HTML za odziv na kopiranje, na primer za posodobitev sporočila na strani.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
oncopy="JavaScript statements"oncopy je globalni atribut za obravnavo dogodka copy, povezanega s kopiranjem. Njegova vrednost vsebuje stavke JavaScript, ne pa logične vrednosti ali zgolj imena funkcije. V kodi atributa parameter event zagotavlja objekt dogodka.
Atribut HTML razlikujte od lastnosti JavaScript element.oncopy, ki ji dodelite funkcijo ali null. Ta lastnost je na voljo tudi na objektih Document in Window. Nova dodelitev zamenja prejšnjo funkcijo te lastnosti; addEventListener('copy', handler) omogoča registracijo neodvisnih poslušalcev.
Kopiranje izbranega besedila v odstavku iz primera ne zagotavlja, da se bo izvedel njegov obravnavalnik dogodka. Pri izboru v območju, ki ga ni mogoče urejati, je po specifikaciji Clipboard API cilj dogodka copy vozlišče, ki ima fokus, ali body, če nobeno vozlišče nima fokusa. Odstavek v primeru ne more prejeti fokusa. Če se njegov obravnavalnik izvede, se sporočilo spremeni v copy; sicer ostane Waiting. Primer ne spremeni kopirane vsebine. Če obravnavalnik vrne false, se dogodek prekliče, če ga je mogoče preklicati. Content Security Policy lahko blokira kodo v atributih; dodajanje oncopy te omejitve ne zaobide.
Primeri
<!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>Rezultat
copy
V izoliranem okolju s Chromiumom se je prikazal rezultat `copy`. V drugih brskalnikih lahko sporočilo ostane `Waiting`.