テキストをコピーする方法

ジョー・メドレー
Joe Medley
Twitter GitHub

テキストの切り取りと貼り付けは、一般的なアプリ、特にデスクトップ アプリケーションで最もよく使われる機能の一つです。ウェブ上でテキストをコピーするにはどうすればよいですか？古い方法と新しい方法があります。これは、使用するブラウザにも左右されます。

最新の手法

Async Clipboard API を使用する

Clipboard.writeText() メソッドは文字列を受け取り、テキストがクリップボードに正常に書き込まれたときに解決される Promise を返します。Clipboard.writeText() は、フォーカスされている window オブジェクトからのみ使用できます。

対応ブラウザ

  • 66
  • 79
  • 63
  • 13.1

ソース

従来のやり方

document.execCommand() の使用

document.execCommand('copy') を呼び出すと、コピーが成功したかどうかを示すブール値が返されます。このコマンドは、クリック ハンドラなどのユーザー操作内で呼び出します。非同期クリップボード API と比較すると、このアプローチには制限があります。execCommand() メソッドは DOM 要素に対してのみ機能します。同期型であるため、大量のデータ、特になんらかの方法で変換またはサニタイズする必要があるデータをコピーすると、ページがブロックされる可能性があります。

対応ブラウザ

  • 1
  • 12
  • 1
  • 1.3

ソース

段階的な補正

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);
  }
});