HTMLElement.oncut

The HTMLElement.oncut property of the HTMLElement interface is an EventHandler that processes cut events.

The cut event fires when the user attempts to cut text.

Syntax

target.oncut = functionRef;

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

Specification

WHATWG Standard

Browser compatibility

Since Firefox 13, the preference dom.event.clipboardevents.enabled controls this feature. It defaults to true but can be disabled.

See also

• Clipboard API event cut
• Related event handlers
  • HTMLElement.oncopy
  • HTMLElement.onpaste