현대적인 방식
Async Clipboard API 사용
사용자의 클립보드에서 프로그래매틱 방식으로 이미지를 읽으려면, 즉 버튼을 클릭한 후 Async Clipboard API의 read()
메서드를 사용하면 됩니다. 클립보드에서 읽을 수 있는 권한이 아직 부여되지 않은 경우 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);
}
});
기존의 방식
paste
이벤트 수신 대기
이미지를 붙여넣는 기본적인 방법은 동기식 클립보드 API를 사용하는 것입니다. 이 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.
}
}
});
점진적 개선
Async Clipboard API를 지원하지 않는 브라우저의 경우 프로그래밍 방식으로 (예: 버튼 클릭 시) 사용자의 클립보드에 액세스할 수 없습니다. 따라서 paste
이벤트에서 사용자의 클립보드에 액세스하려면 Async Clipboard API를 사용하고 (동기식) Clipboard API로 대체할 수 있습니다.
navigator.clipboard.read
에서 비롯된 ClipboardItem
객체에는 배열인 types
필드가 있고 event.clipboardData.files
에서 비롯된 File
객체에는 문자열인 type
필드가 있습니다. 각 type
또는 types
필드에서 클립보드의 이미지를 조건부로 확인할 수 있습니다.
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의 Clipboard API
- web.dev에서 클립보드 액세스 차단 해제
데모
HTML
<!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>
CSS
: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;
}
JS
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);
};