Spec-Zone.ru › Web APIs

Элемент: событие cut

Базовая линия Широко доступно

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

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Событие cut API буфера обмена используется при инициировании пользователем действия "вырезать" через пользовательский интерфейс браузера.

Если пользователь пытается вырезать недопустимое содержимое, событие cut всё равно срабатывает, но объект события не содержит данных.

По умолчанию событие копирует текущий выделенный текст (если таковой есть) в буфер обмена системы и удаляет его из документа.

Обработчик этого события может изменить содержимое буфера обмена, вызвав setData(format, data) свойство объекта события ClipboardEvent.clipboardData и отменить действие по умолчанию, используя event.preventDefault().

Однако отмена действия по умолчанию также предотвратит обновление документа. Таким образом, обработчик событий, который хочет эмулировать действие по умолчанию "вырезать", изменяя содержимое буфера обмена, также должен вручную удалить выделение из документа.

Обработчик не может считывать данные из буфера обмена.

Возможна конструкция и отправка синтетического события синтетического cut события, но это не повлияет на буфер обмена системы или содержимое документа.

Это событие распространяется, является отменяемым и составным.

Синтаксис

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

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

oncut = (event) => {};

Тип события

Тип ClipboardEvent. Наследуется от Event.

Событие ClipboardEvent

Примеры

Пример

HTML

<div class="source" contenteditable="true">Cut text from this box.</div>
<div class="target" contenteditable="true">And paste it into this one.</div>

JavaScript

const source = document.querySelector("div.source");

source.addEventListener("cut", (event) => {
  const selection = document.getSelection();
  event.clipboardData.setData("text/plain", selection.toString().toUpperCase());
  selection.deleteFromDocument();
  event.preventDefault();
});

Результат

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

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

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

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

См. также

  • Связанные события: copy, paste
  • Это событие для Document целей: cut
  • Это событие для Window целей: cut

© 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/Element/cut_event

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API