Navigator.clipboard - Web API 接口参考 编辑

剪贴板 Clipboard API 为 Navigator 接口添加了只读属性 clipboard，该属性返回一个可以读写剪切板内容的 Clipboard 对象。 在 Web 应用中，剪切板 API 可用于实现剪切、复制、粘贴的功能。

只有在用户事先授予网站或应用对剪切板的访问许可之后，才能使用异步剪切板读写方法。许可操作必须通过取得权限 Permissions API 的 "clipboard-read" 和/或 "clipboard-write" 项获得。

语法

theClipboard = navigator.clipboard;

值

用于访问系统剪切板的 Clipboard 对象。

示例

以下代码使用 navigator.clipboard 来访问系统剪切板，以读取系统剪切板的内容。

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

这个代码片段将 HTML 中拥有类名 "cliptext" 的第一个元素的内容替换为剪切板中的内容。这段代码可用于在浏览器拓展中定时自动更新或者由事件触发，实时显示当前剪切板上的内容。

如果剪切板为空，或者不包含文本，则 "cliptext" 元素的内容将被清空。这是因为在剪切板为空或者不包含文本时，readText() 会返回一个空字符串。

标准

标准	状态	备注
Clipboard API and events navigator.clipboard	Working Draft	初次定义

浏览器兼容性

BCD tables only load in the browser

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.