テキストの切り取りと貼り付けは、一般的なアプリ、特にデスクトップ アプリケーションで最もよく使われる機能の一つです。ウェブ上でテキストをコピーするにはどうすればよいですか?古い方法と新しい方法があります。これは、使用するブラウザにも左右されます。
最新の手法
Async Clipboard API を使用する
Clipboard.writeText()
メソッドは文字列を受け取り、テキストがクリップボードに正常に書き込まれたときに解決される Promise を返します。Clipboard.writeText()
は、フォーカスされている window
オブジェクトからのみ使用できます。
従来のやり方
document.execCommand()
の使用
document.execCommand('copy')
を呼び出すと、コピーが成功したかどうかを示すブール値が返されます。このコマンドは、クリック ハンドラなどのユーザー操作内で呼び出します。非同期クリップボード API と比較すると、このアプローチには制限があります。execCommand()
メソッドは DOM 要素に対してのみ機能します。同期型であるため、大量のデータ、特になんらかの方法で変換またはサニタイズする必要があるデータをコピーすると、ページがブロックされる可能性があります。
段階的な補正
const copyButton = document.querySelector('#copyButton');
const out = document.querySelector('#out');
if ('clipboard' in navigator) {
copyButton.addEventListener('click', () => {
navigator.clipboard.writeText(out.value)
.then(() => {
console.log('Text copied');
})
.catch((err) => console.error(err.name, err.message));
});
} else {
copyButton.addEventListener('click', () => {
const textArea = document.createElement('textarea');
textArea.value = out.value;
textArea.style.opacity = 0;
document.body.appendChild(textArea);
textArea.focus();
textArea.select();
try {
const success = document.execCommand('copy');
console.log(`Text copy was ${success ? 'successful' : 'unsuccessful'}.`);
} catch (err) {
console.error(err.name, err.message);
}
document.body.removeChild(textArea);
});
}
参考資料
- クリップボード アクセスのブロックを解除する(最新の方法)
- 切り取りとコピーのコマンド(従来の方法)
デモ
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 copy text</title>
</head>
<body>
<h1>How to copy text</h1>
<textarea rows="3">
Some sample text for you to copy. Feel free to edit this.</textarea
>
<button type="button">Copy</button>
</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
const textarea = document.querySelector('textarea');
const button = document.querySelector('button');
button.addEventListener('click', async () => {
try {
await navigator.clipboard.writeText(textarea.value);
} catch (err) {
console.error(err.name, err.message);
}
});