如何粘贴图片

哈里·西奥杜卢
Harry Theodoulou

如需程序化地(即,点击按钮后)从用户的剪贴板读取图片,您可以使用 Async Clipboard APIread() 方法。如果尚未授予从剪贴板读取的权限,对 navigator.clipboard.read() 的调用将在首次调用该方法时请求相应权限。

const pasteButton = document.querySelector('#paste-button');

pasteButton
.addEventListener('click', async () => {
 
try {
   
const clipboardItems = await navigator.clipboard.read();
   
for (const clipboardItem of clipboardItems) {
     
const imageTypes = clipboardItem.types.find(type => type.startsWith('image/'))
     
for (const imageType of imageTypes) {
       
const blob = await clipboardItem.getType(imageType);
       
// Do something with the image blob.
     
}
   
}
 
} catch (err) {
    console
.error(err.name, err.message);
 
}
});

浏览器支持

  • 86
  • 79
  • 13.1

来源

经典路线

监听 paste 事件

粘贴图片的传统方式是使用(同步)Clipboard API。通过该 API,您可以访问 Document: paste 事件中的 clipboardData 字段。不过,这种方法存在限制,例如,由于它是同步的,粘贴大量数据可能会阻塞网页。

document.addEventListener('paste', async (e) => {
  e
.preventDefault();

 
for (const clipboardItem of e.clipboardData.files) {
   
if (clipboardItem.type.startsWith('image/')) {
     
// Do something with the image file.
   
}
 
}
});

浏览器支持

  • 66
  • 79
  • 63
  • 13.1

来源

渐进式增强

对于不支持 Async Clipboard API 的浏览器,您无法以程序化方式(例如,点击按钮时)访问用户的剪贴板。因此,为了在 paste 事件中访问用户的剪贴板,您可以使用 Async Clipboard API 并回退到(同步)Clipboard API。

来自 navigator.clipboard.readClipboardItem 对象具有 types 字段(数组),而来自 event.clipboardData.filesFile 对象具有 type 字段(字符串)。您可以有条件地检查剪贴板中图片的每个 typetypes 字段:

document.addEventListener('paste', async (e) => {
  e
.preventDefault();
 
const clipboardItems = typeof navigator?.clipboard?.read === 'function' ? await navigator.clipboard.read() : e.clipboardData.files;

 
for (const clipboardItem of clipboardItems) {
    let blob
;
   
if (clipboardItem.type?.startsWith('image/')) {
     
// For files from `e.clipboardData.files`.
      blob
= clipboardItem
     
// Do something with the blob.
   
} else {
     
// For files from `navigator.clipboard.read()`.
     
const imageTypes = clipboardItem.types?.filter(type => type.startsWith('image/'))
     
for (const imageType of imageTypes) {
        blob
= await clipboardItem.getType(imageType);
       
// Do something with the blob.
     
}
   
}
 
}
});

深入阅读

  • MDN 上的剪贴板 API
  • 取消屏蔽 web.dev 上剪贴板的访问权限

演示

<!DOCTYPE html>
<html lang="en">
 
<head>
   
<meta charset="utf-8" />
   
<meta name="viewport" content="width=device-width, initial-scale=1" />
    <link
      rel="icon"
      href="data:image/svg+xml,
<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 100 100%22><text y=%22.9em%22 font-size=%2290%22>🎉</text></svg>"
    />
   
<title>How to paste images</title>
 
</head>
 
<body>
   
<h1>How to paste images</h1>
   
<p>Hit <kbd></kbd> + <kbd>v</kbd> (for macOS) or <kbd>ctrl</kbd> + <kbd>v</kbd>
      (for other operating systems) to paste images anywhere in this page.
   
</p>
 
</body>
</html>

       
:root {
 
color-scheme: dark light;
}

html
{
 
box-sizing: border-box;
}

*,
*:before,
*:after {
 
box-sizing: inherit;
}

body
{
 
margin: 1rem;
 
font-family: system-ui, sans-serif;
}

button
{
 
display: block;
}
       

        document
.addEventListener('paste', async (e) => {
  e
.preventDefault();
 
const clipboardItems = typeof navigator?.clipboard?.read === 'function' ? await navigator.clipboard.read() : e.clipboardData.files;

 
for (const clipboardItem of clipboardItems) {
    let blob
;
   
if (clipboardItem.type?.startsWith('image/')) {
     
// For files from `e.clipboardData.files`.
      blob
= clipboardItem
     
// Do something with the blob.
      appendImage
(blob);
   
} else {
     
// For files from `navigator.clipboard.read()`.
     
const imageTypes = clipboardItem.types?.filter(type => type.startsWith('image/'))
     
for (const imageType of imageTypes) {
        blob
= await clipboardItem.getType(imageType);
       
// Do something with the blob.
        appendImage
(blob);
     
}
   
}
 
}
});

const appendImage = (blob) => {
 
const img = document.createElement('img');
  img
.src = URL.createObjectURL(blob);
  document
.body.append(img);
};