blob: 5fecb4334f51df08b9fd239c291d8b02a726cad7 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
|
---
title: clipboard
slug: Mozilla/Add-ons/WebExtensions/API/剪切板
tags:
- 剪切板
- 扩展
- 附加组件
translation_of: Mozilla/Add-ons/WebExtensions/API/clipboard
---
<div>{{AddonSidebar}}</div>
<p>WebExtention 的 <code>clipboard</code> API 增加了一个将图像复制到剪贴板的函数。目前，这个 API 仅支持复制图像，但我们期望它未来支持复制文本和 HTML（译者注：原文如此，可能是指被支持复制富内容之后的标准剪贴板 API 取代）。</p>
<p>这个 WebExtension API 之所以存在，主要是因为标准的 Web 剪贴板 API <a href="/zh-CN/docs/Web/API/Clipboard_API">Clipboard API</a> 不支持将图像写入剪贴板。一旦标准剪贴板 API 对非文本剪贴板内容的支持进入通用状态，则此 API 可能会被弃用。</p>
<p>Reading from the clipboard is not supported by this API, because the clipboard can already be read using the standard web platform APIs. See <a href="https://wiki.developer.mozilla.org/en-US/Add-ons/WebExtensions/Interact_with_the_clipboard#Reading_from_the_clipboard">Interacting with the clipboard</a>.</p>
<p>This API is based on Chrome's <code><a class="external external-icon" href="https://developer.chrome.com/apps/clipboard">clipboard</a></code> API, but that API is only available for Chrome apps, not extensions.</p>
<p>To use this API you need the <code>"clipboardWrite"</code> extension <a href="https://wiki.developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">permission</a>.</p>
<h2 id="函数">函数</h2>
<dl>
<dt>{{WebExtAPIRef("clipboard.setImageData()")}}</dt>
<dd>复制图像到剪切板。</dd>
</dl>
<h2 id="浏览器兼容性">浏览器兼容性</h2>
<p>{{Compat("webextensions.api.clipboard")}} {{WebExtExamples("h2")}}</p>
<div class="note"><strong>说明</strong>
<p> 此 API 基于 Chromium 的 <a href="https://developer.chrome.com/apps/clipboard"><code>chrome.clipboard</code></a> API.</p>
</div>
|
