Элемент: событие cut
Базовая линия Широко доступно
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с марта 2017 года.
Событие cut API буфера обмена используется при инициировании пользователем действия "вырезать" через пользовательский интерфейс браузера.
Если пользователь пытается вырезать недопустимое содержимое, событие cut всё равно срабатывает, но объект события не содержит данных.
По умолчанию событие копирует текущий выделенный текст (если таковой есть) в буфер обмена системы и удаляет его из документа.
Обработчик этого события может изменить содержимое буфера обмена, вызвав setData(format, data) свойство объекта события ClipboardEvent.clipboardData и отменить действие по умолчанию, используя event.preventDefault().
Однако отмена действия по умолчанию также предотвратит обновление документа. Таким образом, обработчик событий, который хочет эмулировать действие по умолчанию "вырезать", изменяя содержимое буфера обмена, также должен вручную удалить выделение из документа.
Обработчик не может считывать данные из буфера обмена.
Возможна конструкция и отправка синтетического события синтетического cut события, но это не повлияет на буфер обмена системы или содержимое документа.
Это событие распространяется, является отменяемым и составным.
Синтаксис
Используйте имя события в методах, таких как addEventListener(), или задайте свойство обработчика события.
addEventListener("cut", (event) => {});
oncut = (event) => {};
Тип события
Тип ClipboardEvent. Наследуется от Event.
Примеры
Пример
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();
});
Результат
Спецификации
Совместимость браузеров
| Рабочий стол | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 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 |
См. также
© 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