From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- files/ru/web/api/clipboard_api/index.html | 95 +++++++++++++++++++++++++++++++ 1 file changed, 95 insertions(+) create mode 100644 files/ru/web/api/clipboard_api/index.html (limited to 'files/ru/web/api/clipboard_api') diff --git a/files/ru/web/api/clipboard_api/index.html b/files/ru/web/api/clipboard_api/index.html new file mode 100644 index 0000000000..3f31bfe692 --- /dev/null +++ b/files/ru/web/api/clipboard_api/index.html @@ -0,0 +1,95 @@ +--- +title: Clipboard API +slug: Web/API/Clipboard_API +tags: + - API + - Async Clipboard API + - Clipboard + - Clipboard API + - Clipboard Event API + - ClipboardEvent + - ClipboardItem + - Cut + - Landing + - Reference + - copy + - paste +translation_of: Web/API/Clipboard_API +--- +
{{DefaultAPISidebar("Clipboard API")}}
+ +
+ +
Clipboard API предоставляет возможность реагировать на команды буфера обмена (вырезать, копировать и вставить), а также выполнять асинхронные чтение/запись в системный буфер обмена. Доступ к содержимому буфера обмена осуществляется через Permissions API: clipboard-write (разрешение на запись) в буфер обмена автоматически предоставляется страницам, когда они находятся на активной вкладке. Для clipboard-read (чтение из буфера обмена) должно быть запрошено разрешение пользователя. Можно сделать запрос на разрешение, попытавшись прочитать данные из буфера обмена.
+ +
+ +

API предназначен для доступа к буферу обмена, используя {{domxref("document.execCommand()")}}.

+ +

Доступ к буферу обмена

+ +

Вместо создания объекта буфера посредством инициализации экземпляра, вы получаете доступ к системному буферу обмена через глобальный {{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 (API асинхронного буфера обмена)'.
+
{{domxref("ClipboardEvent")}} {{securecontext_inline}}
+
Представляет события, содержащие информацию, относящуюся к модификации буфера обмена, а именно {{domxref("Element/cut_event", "cut")}}, {{domxref("Element/copy_event", "copy")}} и {{domxref("Element/paste_event", "paste")}} события. В спецификации называется 'Clipboard Event API (API событий буфера обмена)'.
+
{{domxref("ClipboardItem")}} {{securecontext_inline}}
+
Представляет единый формат элемента, используемый при чтении или записи данных.
+
+ +

Спецификации

+ + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName('Clipboard API')}}{{Spec2('Clipboard API')}}Первоначальное определение.
+ +

Совместимость с браузером

+ +

Clipboard

+ +
+ + +

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

+ +

ClipboardEvent

+ + + +

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

+ +

ClipboardItem

+ + + +

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

+ +

Смотрите также

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