Copiar texto

Joe medley
Joe Medley
Twitter GitHub

Recortar e colar texto é um dos recursos mais usados de aplicativos em geral e de aplicativos para computador em particular. Como copiar texto na web? Há uma maneira antiga e uma nova maneira. E depende do navegador usado.

O jeito mais moderno

Como usar a API Async Clipboard

O método Clipboard.writeText() usa uma string e retorna uma promessa que é resolvida quando o texto é gravado na área de transferência. Clipboard.writeText() só pode ser usado no objeto window em foco.

Compatibilidade com navegadores

  • 66
  • 79
  • 63
  • 13.1

Origem

A forma clássica

Como usar o document.execCommand()

Chamar document.execCommand('copy') retorna um valor booleano que indica se a cópia foi bem-sucedida. Chame esse comando dentro de um gesto do usuário, como um gerenciador de cliques. Essa abordagem tem limitações em comparação com a API Async Clipboard. O método execCommand() só funciona com elementos DOM. Como é síncrono, copiar grandes quantidades de dados, especialmente aqueles que precisam ser transformados ou limpos de alguma forma, pode bloquear a página.

Compatibilidade com navegadores

  • 1
  • 12
  • 1
  • 1.3

Origem

Aprimoramento progressivo

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

Leia mais

Demonstração

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