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

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

语法

theClipboard = navigator.clipboard;

Copy to Clipboard

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

示例

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

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

Copy to Clipboard

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

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

标准

标准

状态

备注

Clipboard API and eventsnavigator.clipboard

Working Draft

初次定义

浏览器兼容性

Report problems with this compatibility data on GitHub

desktop

mobile

Chrome

Edge

Firefox

Internet Explorer

Opera

Safari

WebView Android

Chrome Android

Firefox for Android

Opera Android

Safari on iOS

Samsung Internet


​clipboard​


66Toggle history

79Toggle history

63Toggle history

NoToggle history

53Toggle history

13.1Toggle history

66Toggle history

66Toggle history

63Toggle history

47Toggle history

13.4Toggle history

9.0Toggle history