dom / latest / htmlelement / cut_event.html /

HTMLElement: cut event

The cut event fires when the user initiates a cut action through the browser's user interface.

Syntax

Use the event name in methods like addEventListener(), or set an event handler property.

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

oncut = event => { };

Event type

Event properties

Also inherits properties from its parent Event.

ClipboardEvent.clipboardData Read only

Is a DataTransfer object containing the data affected by the user-initiated cut, copy, or paste 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

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

© 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