HTMLElement: событие копирования

Базовая поддержка Широко распространено

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с марта 2017 года.

Событие copy срабатывает, когда пользователь инициирует действие копирования через интерфейс пользователя браузера.

Синтаксис

Используйте имя события в методах, таких как addEventListener(), или задайте свойство обработчика события.

addEventListener("copy", (event) => {});

oncopy = (event) => {};

Тип события

Объект ClipboardEvent. Наследуется от Event.

Свойства события

Также наследует свойства от родительского класса Event.

ClipboardEvent.clipboardData Только для чтения: Объект DataTransfer, содержащий данные, затронутые действием пользователя при cut, copy, или paste операциях, а также его MIME-тип.

Пример

В этом примере блокируется любая попытка копирования и вставки из <textarea>.

HTML

<h3>Play with this text area:</h3>
<textarea id="editor" rows="3">
Try copying and pasting text into this field!
</textarea>

<h3>Log:</h3>
<p id="log"></p>

JavaScript

const log = document.getElementById("log");

function logCopy(event) {
  log.innerText = `Copy blocked!\n${log.innerText}`;
  event.preventDefault();
}

function logPaste(event) {
  log.innerText = `Paste blocked!\n${log.innerText}`;
  event.preventDefault();
}

const editor = document.getElementById("editor");

editor.oncopy = logCopy;
editor.onpaste = logPaste;

Результат

Спецификации

Спецификация
API для буфера обмена и события # clipboard-event-copy
HTML # handler-oncopy

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`copy_event`	1	12	22	≤12.1	3	18	22	≤12.1	3	1.0	4.4

См. также

Связанные события
- cut событие
- paste событие

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/copy_event