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

Joe Medley
Joe Medley
GitHub

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

最新の方法

Async Clipboard API を使用する

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

Browser Support

  • Chrome: 66.
  • Edge: 79.
  • Firefox: 63.
  • Safari: 13.1.

Source

従来の方法

document.execCommand() を使用する

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

Browser Support

  • Chrome: 1.
  • Edge: 12.
  • Firefox: 69.
  • Safari: 1.3.

Source

プログレッシブ エンハンスメント

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