如何貼上圖片

哈利.西奧多羅 (Harry Theodoulou)
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,這樣就能存取文件: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 剪貼簿 API,並改回使用 (同步) 剪貼簿 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);
};