Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

oncopy — obsluha události kopírování

Atribut oncopy přiřazuje JavaScriptový kód pro obsluhu události copy. Může být uveden na libovolném prvku HTML a reagovat na kopírování, například aktualizací zprávy na stránce.

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

Syntaxe

oncopy="JavaScript statements"

oncopy je globální atribut obsluhy události copy, která souvisí s kopírováním. Jeho hodnota obsahuje příkazy JavaScriptu, nikoli logickou hodnotu nebo pouze název funkce. V kódu atributu poskytuje parametr event objekt události.

Rozlišujte atribut HTML od vlastnosti JavaScriptu element.oncopy, které se přiřazuje funkce nebo null. Tato vlastnost je dostupná také u objektů Document a Window. Další přiřazení nahradí předchozí funkci této vlastnosti; addEventListener('copy', handler) umožňuje registrovat nezávislé posluchače.

Zkopírování vybraného textu v odstavci z příkladu nezaručuje, že se spustí jeho obsluha události. U výběru v neupravitelné oblasti je podle specifikace Clipboard API cílem události copy uzel, který má fokus, nebo body, pokud žádný uzel fokus nemá. Odstavec v příkladu nemůže získat fokus. Pokud se jeho obsluha spustí, zpráva se změní na copy; jinak zůstane Waiting. Příklad zkopírovaný obsah nemění. Vrácení hodnoty false z obsluhy událost zruší, pokud ji lze zrušit. Content Security Policy může blokovat kód v atributech; přidáním oncopy toto omezení neobejdete.

Pří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ýsledek

copy

V izolovaném prostředí prohlížeče Chromium se zobrazilo `copy`. V jiných prohlížečích může zpráva zůstat `Waiting`.

Zdroje