Document: paste イベント

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.

paste イベントは、ユーザーがブラウザーのユーザーインターフェイスから貼り付け操作が実行されたときに発生します。

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

構文

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

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

onpaste = (event) => {};

イベント型

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

Event ClipboardEvent

例

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

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

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

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

仕様書

Specification
Clipboard API and events
# clipboard-event-paste
HTML Standard
# handler-onpaste

ブラウザーの互換性

BCD tables only load in the browser

関連情報