A RetroSearch Logo

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Search Query:

Showing content from https://developer.mozilla.org/ja/docs/Web/API/Clipboard_API below:

クリップボード API - Web API

クリップボード API

クリップボード API は、クリップボードのコマンド (切り取り、コピー、貼り付け) に応答する機能や、システムクリップボードの非同期の読み取りや書き込みを行う機能を提供します。

メモ: クリップボードにアクセスするには、非推奨の document.execCommand() メソッドよりもこの API を優先して使用してください。

メモ: この API はウェブワーカーでは利用できません。（WorkerNavigator に公開されていません）。

概念と使用法

システムクリップボードは、ブラウザーが動作しているオペレーティングシステムに属するデータバッファーであり、短期間のデータ保存や文書またはアプリケーション間のデータ転送に使用します。 通常、無名で一時的なデータバッファーとして実装されており、ペーストバッファーと呼ばれることもあります。環境内のほとんどまたはすべてのプログラムから定義されたプログラミングインターフェイスを通じてアクセス可能です。

クリップボード API を使うと、ユーザーは保護されたコンテキストの中で、セキュリティに関する考慮事項で指定された条件が成立する限り、テキストや他にも様々な種類のデータをクリップボードにプログラムで読み書きすることができます。

イベントは切り取り (cut)、コピー (copy)、貼り付け (paste) 操作がクリップボードを変更した結果として発行されます。 イベントには既定のアクションがあり、例えば copy アクションは既定では現在の選択部分をシステムクリップボードにコピーします。 既定のアクションはイベントハンドラーで上書きすることができます。詳細は各イベントを参照してください。

インターフェイス
Clipboard 安全なコンテキスト用

システムクリップボードに対してテキストやデータを読み書きするインターフェイスを提供します。 これは仕様書では「非同期クリップボード API」と呼ばれています。

ClipboardEvent

クリップボードの変更に関する情報を提供するイベント、すなわち cut, copy, paste イベントを表します。これは仕様書では「クリップボードイベント API」と呼ばれています。

ClipboardItem 安全なコンテキスト用

データの読み書きの際に使用する単一項目形式を表します。

他のインターフェイスへの拡張

クリップボード API は以下の API を拡張し、掲載されている機能を追加しています。

Navigator.clipboard 読取専用 安全なコンテキスト用

システムクリップボードへの読み書きアクセスを提供する Clipboard オブジェクトを返します。

Element: copy イベント

ユーザーがコピー操作を行うたびに発行されるイベントです。

Element: cut イベント

ユーザーが切り取り操作を行うたびに発行されるイベントです。

Element: paste イベント

ユーザーが貼り付け操作を行うたびに発行されるイベントです。

セキュリティの考慮

クリップボード API は、ユーザーが保護されたコンテキストのシステムクリップボードとの間で、テキストや他の種類のデータをプログラムで読み書きすることをできるようにします。

この仕様では、クリップボードから読み取るために、ユーザーが最近ページを操作したことが要求されます（単発のユーザーの活性化が必要です）。 読み取り処理がブラウザーやOSの「貼り付け要素」（コンテキストメニューなど）とのユーザー対話によって発生した場合、ブラウザーはユーザーに確認を促すことが期待されます。 クリップボードに書き込む場合、詳細度はページが権限 API の clipboard-write 権限を持つことを期待し、ブラウザーは単発のユーザー活性化も要求されるかもしれません。 ブラウザーはクリップボードにアクセスするメソッドを使用する際に、さらに制限を加えるかもしれません。

ブラウザーの実装は仕様から乖離しています。 その違いはブラウザーの互換性の節にまとめられており、現在の状態の概要は下記の通りです。

Chromium 系のブラウザー:

Firefox および Safari:

Firefox の Web Extensions:

例 クリップボードへのアクセス

システムクリップボードには、グローバルの Navigator.clipboard を通してアクセスします。

このスニペットはクリップボードからテキストを読み取り、最初に見つかった editor クラスを持つ要素に追加します。 readText() (および場合によっては read()) はクリップボードにテキストがないときには空文字列を返すので、このコードは安全です。

navigator.clipboard
  .readText()
  .then(
    (clipText) => (document.querySelector(".editor").innerText += clipText),
  );
仕様書 ブラウザーの互換性 api.Clipboard api.ClipboardEvent api.ClipboardItem 関連情報

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4