Document: copy イベント

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

このイベントの本来の対象は、コピー操作の意図の対象である Element です。このイベントを Document インターフェイス上で待ち受けし、キャプチャやバブリングの局面で処理することができます。このイベントの局面について完全な詳細は、 Element: copy イベントを参照してください。

構文

このイベント名を addEventListener() などのメソッドで使用するか、イベントハンドラーのプロパティを設定するかしてください。

js
addEventListener("copy", (event) => {});

oncopy = (event) => {};

イベント型

ClipboardEvent です。Event から継承しています。

Event ClipboardEvent

例

ユーザーがウェブページのデータをクリップボードにコピーしたときに通知されるようにするには、Document インスタンスに addEventListener() を使用してハンドラーを追加してください。

js
document.addEventListener("copy", (event) => {
  /* セッションはシャットダウンしている */
});

また、Document.oncopy イベントハンドラープロパティを使用して、copy イベントのハンドラーを確立することもできます。

js
document.oncopy = (event) => {
  /* セッションはシャットダウンしている */
};

仕様書

Specification
Clipboard API and events
# clipboard-event-copy
HTML Standard
# handler-oncopy

ブラウザーの互換性

BCD tables only load in the browser

関連情報