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
# handler-onpaste

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
paste event

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

関連情報