--- title: HTMLElement.oncut slug: Web/API/HTMLElement/oncut tags: - API - Event Handler - Experimental - HTMLElement - NeedsSpecTable - Property - Reference browser-compat: api.HTMLElement.oncut translation_of: Web/API/HTMLElement/oncut ---
{{ APIRef("HTML DOM") }} {{SeeCompatTable}}

HTMLElement.oncut は {{domxref("HTMLElement")}} インターフェイスのプロパティで、 {{event("cut")}} イベントを処理するイベントハンドラーです。

cut イベントは、ユーザーがテキストを切り取りしようとしたときに発行されます。

構文

target.oncut = functionRef;

値

functionRef は関数名または関数式です。この関数は唯一の引数として {{domxref("ClipboardEvent")}} オブジェクトを受け取ります。

例

この例では、テキストを {{htmlElement("textarea")}} からコピーすることはできますが、テキストを切り取りすることはできません。また、コピーと切り取りを仕様としたことをそれぞれ記録します。

HTML

<h3>このテキストエリアで実行しましょう。</h3>
<textarea id="editor" rows="3">このフィールド内のテキストをコピーしたり切り取りしたりしてみましょう。</textarea>

<h3>ログ:</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;

結果

{{EmbedLiveSample("Example", 700, 300)}}

仕様書

WHATWG 標準

ブラウザーの互換性

{{Compat}}

Firefox 13 以降では、設定項目 dom.event.clipboardevents.enabled でこの機能を制御できます。既定では true になっていますが、無効にすることができます。

関連情報