WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

oncopy — Handler für das Kopierereignis

Das Attribut oncopy weist JavaScript-Code zu, der das copy-Ereignis behandelt. Es kann auf jedem HTML-Element stehen, um auf einen Kopiervorgang zu reagieren, zum Beispiel indem eine Meldung auf der Seite aktualisiert wird.

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

Syntax

oncopy="JavaScript statements"

oncopy ist ein globales Ereignisbehandlungsattribut für copy, das mit dem Kopieren verbundene Ereignis. Sein Wert enthält JavaScript-Anweisungen, keinen booleschen Wert und nicht nur einen Funktionsnamen. Im Attributcode stellt der Parameter event das Ereignisobjekt bereit.

Unterscheide das HTML-Attribut von der JavaScript-Eigenschaft element.oncopy, der eine Funktion oder null zugewiesen wird. Diese Eigenschaft ist auch für Document- und Window-Objekte verfügbar. Eine erneute Zuweisung ersetzt die zuvor zugewiesene Funktion; mit addEventListener('copy', handler) lassen sich unabhängige Listener registrieren.

Beim Kopieren von markiertem Text im Beispielabsatz wird dessen Handler nicht zwangsläufig ausgeführt. Bei einer Auswahl in einem nicht bearbeitbaren Bereich ist laut Clipboard-API-Spezifikation der Knoten mit Fokus das Ziel des copy-Ereignisses. Hat kein Knoten den Fokus, ist body das Ziel. Der Beispielabsatz kann keinen Fokus erhalten. Wird sein Handler ausgeführt, ändert sich die Meldung in copy; andernfalls bleibt sie bei Waiting. Das Beispiel ändert den kopierten Inhalt nicht. Gibt der Handler false zurück, wird das Ereignis abgebrochen, sofern es abbrechbar ist. Eine Content Security Policy kann Code in Attributen blockieren; das Hinzufügen von oncopy umgeht diese Einschränkung nicht.

Beispiele

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

Ergebnis

copy

In einer isolierten Chromium-Umgebung wurde `copy` angezeigt. In anderen Browsern kann die Meldung bei `Waiting` bleiben.

Quellen