Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / HTML

oncopy — rukovatelj događajem kopiranja

Atribut oncopy dodjeljuje JavaScript kod za rukovanje događajem copy. Može se nalaziti na bilo kojem HTML elementu i reagirati na kopiranje, primjerice ažuriranjem poruke na stranici.

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

Sintaksa

oncopy="JavaScript statements"

oncopy je globalni atribut za rukovanje događajem copy, povezanim s kopiranjem. Njegova vrijednost sadrži JavaScript naredbe, a ne Booleovu vrijednost niti samo naziv funkcije. U kodu atributa parametar event pruža objekt događaja.

Razlikujte HTML atribut od JavaScript svojstva element.oncopy, kojem se dodjeljuje funkcija ili null. To je svojstvo dostupno i na objektima Document i Window. Ponovna dodjela zamjenjuje prethodnu funkciju tog svojstva; addEventListener('copy', handler) omogućuje registraciju neovisnih slušatelja.

Kopiranje odabranog teksta u odlomku iz primjera ne jamči da će se izvršiti njegov rukovatelj događajem. Prema specifikaciji Clipboard API-ja, za odabir u području koje se ne može uređivati cilj je događaja copy čvor koji ima fokus ili body ako nijedan čvor nema fokus. Odlomak iz primjera ne može primiti fokus. Ako se njegov rukovatelj izvrši, poruka se mijenja u copy; inače ostaje Waiting. Primjer ne mijenja kopirani sadržaj. Vraćanje vrijednosti false iz rukovatelja otkazuje događaj ako ga je moguće otkazati. Content Security Policy može blokirati kod u atributima; dodavanje oncopy ne zaobilazi to ograničenje.

Primjeri

<!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

U izoliranom okruženju s preglednikom Chromium prikazan je rezultat `copy`. U drugim preglednicima poruka može ostati `Waiting`.

Izvori