CKTIS / HTML
oncopy — obsluha udalosti kopírovania
Atribút oncopy priraďuje JavaScriptový kód na obsluhu udalosti copy. Môže byť uvedený na ľubovoľnom prvku HTML a reagovať na kopírovanie, napríklad aktualizáciou správy na stránke.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
oncopy="JavaScript statements"oncopy je globálny atribút obsluhy udalosti copy, ktorá súvisí s kopírovaním. Jeho hodnota obsahuje príkazy JavaScriptu, nie logickú hodnotu ani iba názov funkcie. V kóde atribútu poskytuje parameter event objekt udalosti.
Rozlišujte atribút HTML od vlastnosti JavaScriptu element.oncopy, ktorej sa priraďuje funkcia alebo null. Táto vlastnosť je dostupná aj na objektoch Document a Window. Ďalšie priradenie nahradí predchádzajúcu funkciu tejto vlastnosti; addEventListener('copy', handler) umožňuje registrovať nezávislé listenery.
Skopírovanie vybraného textu v odseku z príkladu nezaručuje, že sa spustí jeho obsluha udalosti. Pri výbere v neupraviteľnej oblasti je podľa špecifikácie Clipboard API cieľom udalosti copy uzol, ktorý má fokus, alebo body, ak žiadny uzol nemá fokus. Odsek v príklade nemôže získať fokus. Ak sa jeho obsluha spustí, správa sa zmení na copy; inak zostane Waiting. Príklad skopírovaný obsah nemení. Vrátenie hodnoty false z obsluhy zruší udalosť, ak sa dá zrušiť. Content Security Policy môže blokovať kód v atribútoch; pridaním oncopy toto obmedzenie neobídete.
Príklady
<!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>Výsledok
copy
V izolovanom prostredí prehliadača Chromium sa zobrazilo `copy`. V iných prehliadačoch môže správa zostať `Waiting`.