We're looking for a user researcher to understand the needs of developers and designers. Is this you or someone you know? Check out the post: https://mzl.la/2IGzdXS

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

一般情報

仕様書 Clipboard
インターフェイス ClipboardEvent
バブル
キャンセル
対象オブジェクト Element: フォーカスされた要素 (contentEditable 要素については選択範囲の開始位置を含む要素)、または <body> 要素。
既定の動作 下記参照。

このイベントのハンドラは、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() を呼び出さずにイベントをキャンセルした場合、何も動作しません。

プロパティ

Property Type Description
target 読取専用 EventTarget The event target (the topmost target in the DOM tree).
type 読取専用 DOMString The type of event.
bubbles 読取専用 Boolean Whether the event normally bubbles or not.
cancelable 読取専用 Boolean Whether the event is cancellable or not.

ブラウザ実装状況

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
基本サポート (有) (有) ? ? ?
clipboardData (有) 22 (22) 未サポート ? ?
機能 Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
基本サポート ? (有) ? ? ?
clipboardData ? 22.0 (22) ? ? ?

ドキュメントのタグと貢献者

このページの貢献者: fscholz, Marsf
最終更新者: fscholz,