The cut
event fires when the user initiates a cut action through the browser's user interface.
HTMLElement: cut event
Syntax
Use the event name in methods like addEventListener()
, or set an event handler property.
addEventListener('cut', event => { }); oncut = event => { };
Event type
A ClipboardEvent
. Inherits from Event
.
Event properties
Also inherits properties from its parent Event
.
-
ClipboardEvent.clipboardData
Read only -
Is a
DataTransfer
object containing the data affected by the user-initiatedcut
,copy
, orpaste
operation, along with its MIME type.
Value
functionRef
is a function name or a function expression. The function receives a ClipboardEvent
object as its sole argument.
Example
This example allows text to be copied from the <textarea>
, but doesn't allow text to be cut. It also logs each copy and cut attempt.
HTML
<h3>Play with this text area:</h3> <textarea id="editor" rows="3">Try copying and cutting the text in this field!</textarea> <h3>Log:</h3> <p id="log"></p>
JavaScript
function logCopy(event) { log.innerText = 'Copied!\n' + log.innerText; } function preventCut(event) { event.preventDefault(); log.innerText = 'Cut blocked!\n' + log.innerText; } const editor = document.getElementById('editor'); const log = document.getElementById('log'); editor.oncopy = logCopy; editor.oncut = preventCut;
Result
Specifications
Specification |
---|
HTML Standard # handler-oncut |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
cut_event |
1
|
12
|
9
|
9
5.5
Before Internet Explorer 9, this event is not supported via
addEventListener .
|
≤12.1
|
3
|
1
|
18
|
9
|
≤12.1
|
1
|
1.0
|
See also
- Related events
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/cut_event