CKTIS / HTML
oncopy — handler voor de kopieergebeurtenis
Het attribuut oncopy koppelt JavaScript-code aan de afhandeling van de copy-gebeurtenis. Het kan op elk HTML-element staan om op kopiëren te reageren, bijvoorbeeld door een bericht op de pagina bij te werken.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
oncopy="JavaScript statements"oncopy is een globaal gebeurtenishandlerattribuut voor copy, de gebeurtenis die bij kopiëren hoort. De waarde bevat JavaScript-instructies, geen booleaanse waarde en ook niet alleen een functienaam. In de attribuutcode geeft de parameter event toegang tot het gebeurtenisobject.
Maak onderscheid tussen het HTML-attribuut en de JavaScript-eigenschap element.oncopy, waaraan je een functie of null toewijst. Deze eigenschap is ook beschikbaar op Document- en Window-objecten. Een nieuwe toewijzing vervangt de vorige functie van de eigenschap; met addEventListener('copy', handler) registreer je onafhankelijke listeners.
Als je geselecteerde tekst in de voorbeeldalinea kopieert, wordt de handler van die alinea niet gegarandeerd uitgevoerd. Bij een selectie in een niet-bewerkbaar gebied is volgens de Clipboard API-specificatie het knooppunt met focus het doel van de copy-gebeurtenis. Heeft geen enkel knooppunt focus, dan is body het doel. De voorbeeldalinea kan geen focus krijgen. Als de handler wordt uitgevoerd, verandert het bericht in copy; anders blijft het op Waiting staan. Het voorbeeld wijzigt de gekopieerde inhoud niet. Als de handler false teruggeeft, wordt de gebeurtenis geannuleerd als dat mogelijk is. Content Security Policy kan code in attributen blokkeren; oncopy toevoegen omzeilt die beperking niet.
Voorbeelden
<!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>Resultaat
copy
In een geïsoleerde Chromium-omgeving verscheen `copy`. In andere browsers kan het bericht op `Waiting` blijven staan.