copy

copy イベントは、ユーザがブラウザの UI を通じて コピー操作を起こした時 (例えば、キーボードショートカットの CTRL/Cmd+C を押した時やメニューから "コピー" を選んだ時) に発火し、許可された document.execCommand('copy') 呼び出しに応答します。

一般情報

このイベントのハンドラは、setData(format, data) の呼び出しにより提供された ClipboardEvent.clipboardData オブジェクトを変更できます:

document.addEventListener('copy', function(e){
    e.clipboardData.setData('text/plain', 'Hello, world!');
    e.clipboardData.setData('text/html', '<b>Hello, world!</b>');
    e.preventDefault(); // We want our data, not data from any selection, to be written to the clipboard
});

このイベントのハンドラは、clipboardData.getData() を使用してもクリップボードのデータを読めません。

イベントの既定の動作は、イベントの呼び出し元に依存し、ハンドラの動作は以下のようになります:

• 合成された copy イベントは、既定の動作を持ちません。ただし、以下の動作をします。
• イベントがキャンセルされなかった場合、(もしあれば) 選択範囲をクリップボードへコピーします。
• ハンドラがイベントをキャンセルして setData() を呼び出した場合、clipboardData の内容をクリップボードへコピーします。
• ハンドラが setData() を呼び出さずにイベントをキャンセルした場合、何も動作しません。

プロパティ

ブラウザ実装状況

関連イベント

• Copy 関連のイベント: copy、cut、paste