Clipboard events
ClipboardEvent はクリップボード API のインターフェイスで、 クリップボードの変更に関連する情報を提供するイベントを表します。すなわち、cut、copy、paste イベントです。
Event ClipboardEvent
対応ブラウザ
| 機能 | デスクトップ | モバイル | ||||
|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Safari | Chrome Android | Safari iOS | |
| 41 | 12 | 22 | 10.1 | 41 | 10.3 | |
| ClipboardEvent.clipboardData プロパティは、DataTransfer オブジェクトを保持し、次のように使用します。 | 41 | 12 | 22 | 10.1 | 41 | 10.3 |
| ClipboardEvent() コンストラクターは、新たに生成された ClipboardEvent を返します。これは、Element/cutevent や Element/copyevent、Element/paste_event イベントで変更されたクリップボード関連の情報を提供するイベントを表します。 | 58 | 17 | 22 | 10.1 | 58 | 10.3 |
| copy イベントは、ユーザーがブラウザーのユーザーインターフェイスからコピー操作を実行したときに発生します。 | 1 | 12 | 22 | 3 | 18 | 3 |
| cut イベントは、ユーザーがブラウザーのユーザーインターフェイスから「切り取り」操作を実行したときに発生します。 | 1 | 12 | 22 | 3 | 18 | 3 |
| paste イベントは、ユーザーがブラウザーのユーザーインターフェイスで「貼り付け」操作を行ったときに発生します。 | 1 | 12 | 22 | 3 | 18 | 3 |
注釈 2件
実装メモ
- 複数のファイルを貼り付ける際、最初のファイルしか返されません。バグ 1954680 を参照してください。
- Firefox 140 以前のバージョンでは、複数のファイルを貼り付ける際に、最初のファイルが有効でなかった場合、ファイルが一切反映されませんでした。バグ 1961170 を参照してください。
実務での使いどころ
-
Clipboard events の活用
ClipboardEvent はクリップボード API のインターフェイスで、 クリップボードの変更に関連する情報を提供するイベントを表します。
注意点
- 古いブラウザでは対応していない場合がある。
実装メモ
- 一部の API はセキュアコンテキスト (HTTPS) やユーザー操作起点を必要とする。利用前に要件を確認すること。