现代主流方式是使用 navigator.clipboard API,它比旧的 document.execCommand 更安全可靠,支持文本和二进制数据,但需安全上下文和用户手势触发。
JavaScript 实现复制到剪贴板,现代主流方式是使用 navigator.clipboard API,它比旧的 document.execCommand 更安全、更可靠,且支持文本和二进制数据(如图片)。但需注意权限与上下文限制。
这是最常用的方法,适用于复制字符串内容。调用前需确保页面处于安全上下文(HTTPS 或 localhost),且必须由用户手势(如 click、keydown)触发。
async function copyToClipboard(text) {
try {
await navigator.clipboard.writeText(text);
console.log('复制成功');
} catch (err) {
console.error('复制失败:', err);
}
}
// 绑定到按钮点击
document.getElementById('copyBtn').addEventListener('click', () => {
copyToClipboard('Hello, Clipboard!');
});
允许网页主动读取用户剪贴板中的文本内容(同样需用户手势触发 + 安全上下文)。常用于粘贴功能或内容预览。
如果想复制带格式的 HTML(比如保留加粗、链接),不能只用 writeText,而要用 clipboard.write() 和 ClipboardItem。
async function copyHtml(htmlString) {
const htmlBlob = new Blob([htmlString], { type: 'text/html' });
const plainBlob = new Blob(['Plain version'], { type: 'text/plain' });
try {
await navigator.clipboard.write([
new ClipboardItem({
'text/html': htmlBlob,
'text/plain': plainBlob
})
]);
} catch (err) {
console.error('HTML 复制失败:', err);
}
}
(execCommand)对于仍需支持 IE11 或老版本 Safari 的场景,可 fallback 到 document.execCommand('copy'),但该方法已被废弃,且要求 input/textarea 聚焦并选中内容。