在日常业务开发,比如复制后增加版权信息,点击复制,等场景中需要进行复制粘贴的操作,以下是几种实现方案。
Clipboard API 提供了响应剪贴板命令(剪切、复制和粘贴)与异步读写系统剪贴板的能力。从权限 API (Permissions API) 获取权限之后,才能访问剪贴板内容;如果用户没有授予权限,则不允许读取剪贴板内容。
可以使用全局的 Navigator.clipboard 来访问剪贴板。
Navigator.clipboard 属性返回 Clipboard 对象,所有操作都通过这个对象进行。
Clipboard 对象提供了四个方法,用来读写剪贴板。它们都是异步方法,返回 Promise 对象。
read( ) 方法
方法可以从剪贴板读取任意数据,可以是文本数据,也可以是二进制数据(比如图片)。该方法需要用户明确给予许可。
方法返回一个 对象。一旦该对象的状态变为 ,就可以获得一个数组,每个数组成员都是 ClipboardItem 对象的实例。
ClipboardItem 对象表示一个单独的剪贴项,每个剪贴项都拥有 属性和 方法。
属性返回一个数组,里面的成员是该剪贴项可用的 类型,比如某个剪贴项可以用 格式粘贴,也可以用纯文本格式粘贴,那么它就有两个 类型( 和 )。
方法用于读取剪贴项的数据,返回一个 对象。该方法接受剪贴项的 类型作为参数,返回该类型的数据,该参数是必需的,否则会报错。
示例:
readText( ) 方法
方法可以从剪贴板读取文本内容。该方法需要用户明确给予许可。
示例:
write( ) 方法
方法可以将任意数据写入剪贴板,可以是文本数据,也可以是二进制数据。该方法不需要用户许可。
方法接受一个 ClipboardItem 实例作为参数,表示写入剪贴板的数据。
示例:
注意,Chrome 浏览器目前只支持写入 PNG 格式的图片。
writeText( ) 方法
方法可以写入文本内容至剪贴板。该方法不需要用户许可。
示例:
安全限制
由于用户可能把敏感数据(比如密码)放在剪贴板,允许脚本任意读取会产生安全风险,所以这个 API 的安全限制比较多。
首先,Chrome 浏览器规定,只有 HTTPS 协议的页面才能使用这个 API。不过,开发环境()允许使用非加密协议。
其次,调用时需要明确获得用户的许可。权限的具体实现使用了 Permissions API ,跟剪贴板相关的有两个权限:(写权限)和 (读权限)。“写权限”自动授予脚本,而“读权限”必须用户明确同意给予。也就是说,写入剪贴板,脚本可以自动完成,但是读取剪贴板时,浏览器会弹出一个对话框,询问用户是否同意读取。
这个 API 已弃用,不推荐使用它,但是为了兼容还是了解一下吧。
方法用于操纵可编辑区域的内容。
实现复制操作
示例:
实现粘贴操作
示例:
Chrome、Firefox 不支持
除了使用原生 JS 外,还可以使用一些第三方的库,比如 clipboard.js 来实现复制文本到剪贴板的操作。
安装
npm 安装
script 标签引入
使用
1、用一个元素当触发器来复制另一个元素的文本,需要传递 选择器, 元素或 元素列表来实例化它。
2、在触发器元素上添加 属性,该属性值是一个元素选择器,用来匹配另一个需要被复制的元素。
示例:
另外,触发器元素上也可以定义 属性为 或 ,来明确操作是复制还是剪切,如果忽略了这个属性,则默认是复制。值为 时仅适用于 或 元素。
如果在触发器元素上定义 属性,则不需要另一个元素来复制其内容。 属性值就是需要被复制的内容。
示例:
copy 事件
用户向剪贴板放入数据时,将触发 事件。
示例:
clipboardData 对象
上面示例中,事件对象的 clipboardData 属性包含了剪贴板数据。它是一个对象,有以下属性和方法。
方法
:在 和 事件中修改剪贴板数据,需要指定数据类型。
示例:
方法
:在 事件中获取剪贴板数据,需要指定数据类型。
示例:
属性
:一个类似数组的对象,包含了所有剪贴项,不过通常只有一个剪贴项。
cut 事件
事件则是在用户进行剪切操作时触发,它的处理跟 事件完全一样,也是从 属性拿到剪切的数据。
示例:
paste 事件
用户使用剪贴板数据,进行粘贴操作时,会触发 事件。
示例:
-
点击复制
-
读取剪贴板图片
-
复制追加版权信息
Web 一键复制与粘贴
剪贴板复制粘贴操作汇总
JavaScript复制内容到剪贴板
剪贴板操作 Clipboard API 教程