Element: copy イベント

copy イベントは、ユーザーがブラウザーのユーザーインターフェイスからコピー操作を実行したときに発生します。

バブリング あり
キャンセル
インターフェイス ClipboardEvent
イベントハンドラープロパティ oncopy

このイベントの既定の動作は、 (もしあれば) 選択範囲をクリップボードへコピーすることです。

このイベントのハンドラーは、 setData(format, data) をイベントの ClipboardEvent.clipboardData プロパティに対して呼び出すことで、クリップボードの内容を変更したり、 event.preventDefault() を使用してイベントの既定の動作を取り消したりすることができます。

ただし、ハンドラーがクリップボードのデータを読み取ることはできません。

仮想の copy イベントを構築して配信することもできますが、システムのクリップボードには影響を与えません。

ライブデモ

HTML

<div class="source" contenteditable="true">Try copying text from this box...</div>
<div class="target" contenteditable="true">...and pasting it into this one</div>

JS

const source = document.querySelector('div.source');

source.addEventListener('copy', (event) => {
    const selection = document.getSelection();
    event.clipboardData.setData('text/plain', selection.toString().toUpperCase());
    event.preventDefault();
});

結果

仕様書

仕様書 状態
Clipboard API and events 草案

ブラウザーの互換性

BCD tables only load in the browser

関連情報