oncopy
プロパティは HTMLElement
インターフェイスのプロパティで、 copy
イベントを処理するイベントハンドラー (EventHandler
) です。
copy
イベントはユーザーがテキストをコピーしようとしたときに発生します。
構文
target.oncopy = functionRef;
値
functionRef
は関数名または関数式です。この関数は ClipboardEvent
オブジェクトを唯一の引数として受け取ります。
例
この例では、 <textarea>
からのすべてのコピーと貼り付けをブロックします。
HTML
<h3>Play with this text area:</h3>
<textarea id="editor" rows="3">Try copying and pasting text into this field!</textarea>
<h3>Log:</h3>
<p id="log"></p>
JavaScript
const log = document.getElementById('log');
function logCopy(event) {
log.innerText = 'Copy blocked!\n' + log.innerText;
event.preventDefault();
}
function logPaste(event) {
log.innerText = 'Paste blocked!\n' + log.innerText;
event.preventDefault();
}
const editor = document.getElementById('editor');
editor.oncopy = logCopy;
editor.onpaste = logPaste;
結果
仕様書
ブラウザーの互換性
BCD tables only load in the browser
このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 https://github.com/mdn/browser-compat-data をチェックアウトしてプルリクエストを送信してください。
Firefox 13 から、この機能は設定 dom.event.clipboardevents.enabled
で制御されます。既定値は true
ですが無効化できます。
関連情報
- Clipboard API のイベント
copy
- 関連するイベントハンドラー