Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje