Document: copy イベント

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.

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

関連情報