Clipboard API
Clipboard API 的 Clipboard 接口提供系统剪贴板读写访问的权限。这让 Web 应用程序可以实现剪切、复制和粘贴功能。
系统剪贴板暴露于全局属性 Navigator.clipboard 之中。
所有 Clipboard API 方法都是异步的;它们返回一个 Promise 对象,在剪贴板访问完成后被兑现。如果剪贴板访问被拒绝,promise 也会被拒绝。
所有的方法也都需要安全上下文。使用 API 的其他要求在 API 概述主题的安全考虑部分进行了讨论。
方法
Clipboard 继承自 EventTarget 接口,因此拥有它的方法。
- Clipboard.read()
- : 从剪贴板读取数据(比如图片),返回一个 Promise。在检索到数据后,其将兑现为包含剪贴板数据的 ClipboardItem 对象数组。
- Clipboard.readText()
- : 从操作系统剪切板读取文本,返回一个 Promise,一旦数据可用,其将兑现为包含剪切板文本的字符串。
- Clipboard.write()
- : 写入任意数据至操作系统剪贴板,返回一个在操作完成时被兑现的 Promise。
- Clipboard.writeText()
- : 写入文本至操作系统剪贴板。返回一个在文本已被完全写入剪贴板后兑现的 Promise。
规范
浏览器兼容性
参见
- Document.execCommand()
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
