From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/ja/web/api/clipboard_api/index.html | 77 +++++++++++++++++++++++++++++++ 1 file changed, 77 insertions(+) create mode 100644 files/ja/web/api/clipboard_api/index.html (limited to 'files/ja/web/api/clipboard_api') diff --git a/files/ja/web/api/clipboard_api/index.html b/files/ja/web/api/clipboard_api/index.html new file mode 100644 index 0000000000..2ad9f4e43f --- /dev/null +++ b/files/ja/web/api/clipboard_api/index.html @@ -0,0 +1,77 @@ +--- +title: クリップボード API +slug: Web/API/Clipboard_API +tags: + - API + - Async Clipboard API + - Clipboard + - Clipboard API + - Clipboard Event API + - ClipboardEvent + - Landing + - Reference +translation_of: Web/API/Clipboard_API +--- +
{{DefaultAPISidebar("Clipboard API")}}
+ +

クリップボード API は、クリップボードのコマンド (切り取り、コピー、貼り付け) に応答する機能や、システムクリップボードの非同期の読み取りや書き込みを行う機能を提供します。クリップボードの内容へのアクセスは、 Permissions API によって制限されています。ユーザーの許可がなければ、クリップボードの内容の読み取りや変更は許可されません。

+ +

この API は、 {{domxref("document.execCommand()")}} を使用したクリップボードへのアクセスに取って代わるように設計されています。

+ +

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

+ +

Clipboard オブジェクトをインスタンス化して生成するのではなく、システムクリップボードにはグローバル変数の {{domxref("Navigator.clipboard")}} を通してアクセスすることができます。

+ +
navigator.clipboard.readText().then(
+  clipText => document.querySelector(".editor").innerText += clipText);
+ +

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

+ +

インターフェイス

+ +
+
{{domxref("Clipboard")}} {{securecontext_inline}}
+
システムクリップボードに対してテキストやデータを読み書きするインターフェイスを提供します。これは仕様書では 'Async Clipboard API' と呼ばれています。
+
{{domxref("ClipboardEvent")}} {{securecontext_inline}}
+
クリップボードの変更に関する情報を提供するイベント、すなわち {{domxref("Element/cut_event", "cut")}}, {{domxref("Element/copy_event", "copy")}}, {{domxref("Element/paste_event", "paste")}} イベントを表します。これは仕様書では 'Clipboard Event API' と呼ばれています。
+
+ +

仕様書

+ + + + + + + + + + + + + + +
仕様書状態備考
{{SpecName('Clipboard API')}}{{Spec2('Clipboard API')}}初回定義
+ +

ブラウザーの互換性

+ +

Clipboard

+ +
+ + +

{{Compat("api.Clipboard")}}

+ +

ClipboardEvent

+ + + +

{{Compat("api.ClipboardEvent")}}

+ +

関連情報

+ + +
-- cgit v1.2.3-54-g00ecf