CKTIS / HTML
oncopy — обработчик на събитието за копиране
Атрибутът oncopy задава JavaScript код за обработка на събитието copy. Може да се използва върху всеки HTML елемент, за да реагира на копиране, например чрез актуализиране на съобщение на страницата.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
oncopy="JavaScript statements"oncopy е глобален атрибут за обработка на събитието copy, свързано с копирането. Стойността му съдържа JavaScript инструкции, а не булева стойност или просто име на функция. В кода на атрибута параметърът event предоставя обекта на събитието.
Разграничавайте HTML атрибута от JavaScript свойството element.oncopy, на което се задава функция или null. Това свойство е налично и при обектите Document и Window. Повторното задаване заменя предишната функция на свойството; addEventListener('copy', handler) позволява регистриране на независими слушатели.
Копирането на избран текст в абзаца от примера не гарантира, че неговият обработчик ще се изпълни. Според спецификацията на Clipboard API при селекция в област, която не може да се редактира, събитието copy е насочено към възела, който има фокус, или към body, ако никой възел няма фокус. Абзацът в примера не може да получи фокус. Ако обработчикът му се изпълни, съобщението се променя на copy; в противен случай остава Waiting. Примерът не променя копираното съдържание. Връщането на false от обработчика отменя събитието, ако то може да бъде отменено. Content Security Policy може да блокира код в атрибутите; добавянето на oncopy не заобикаля това ограничение.
Примери
<!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>Резултат
copy
Резултатът `copy` е наблюдаван в изолирана среда с Chromium. В други браузъри съобщението може да остане `Waiting`.