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

使用匿名的剪切板读写方法,要求用户事先取得网站或应用对剪切板的访问许可。许可操作须由 权限API 的 "clipboard-read" 和/或 "clipboard-write" 获得。

语法

theClipboard = navigator.clipboard;

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

示例

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

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

这个代码片段将 HTML 中所有拥有 "cliptext" class的元素的内容替换为剪切板中的内容。可能这段代码会用于浏览器插件中来显示当前剪切板上的内容,定时自动更新或者由特定事件出发。

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

标准

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

浏览器兼容性

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
clipboardChrome Full support 66Edge ? Firefox Full support 63IE ? Opera Full support YesSafari ? WebView Android Full support 66Chrome Android Full support 66Firefox Android Full support 63Opera Android Full support YesSafari iOS ? Samsung Internet Android Full support Yes

Legend

Full support  
Full support
Compatibility unknown  
Compatibility unknown

文档标签和贡献者

此页面的贡献者: mdnwebdocs-bot, Roy-Tian
最后编辑者: mdnwebdocs-bot,