Como colar texto

Harry Theodoulou
Harry Theodoulou

Para ler o texto da área de transferência do usuário de maneira programática, por exemplo, após um clique no botão, use o método readText() da API Async Clipboard. Se as permissões para ler a área de transferência ainda não tiverem sido concedidas, a chamada para navigator.clipboard.readText() vai solicitá-la na primeira chamada para o método.

const pasteButton = document.querySelector('#paste-button');

pasteButton
.addEventListener('click', async () => {
   
try {
     
const text = await navigator.clipboard.readText()
     document
.querySelector('textarea').value += text;
     console
.log('Text pasted.');
   
} catch (error) {
     console
.log('Failed to read clipboard');
   
}
});

Compatibilidade com navegadores

  • 66
  • 79
  • x
  • 13.1

Origem

A forma clássica

Como usar o document.execCommand()

Com a document.execCommand('paste'), você pode colar o conteúdo da área de transferência no ponto de inserção (o elemento HTML em foco no momento). O método execCommand retorna um booleano que indica se o evento paste foi bem-sucedido. No entanto, esse método tem limitações, por exemplo, por ser síncrono, colar grandes quantidades de dados pode bloquear a página.

pasteButton.addEventListener('click', () => {
  document
.querySelector('textarea').focus();
 
const result = document.execCommand('paste')
  console
.log('document.execCommand result: ', result);
})

Compatibilidade com navegadores

  • 1
  • 12
  • 1
  • 1.3

Origem

Aprimoramento progressivo

pasteButton.addEventListener('click', async () => {
   
try {
     
const text = await navigator.clipboard.readText()
     document
.querySelector('textarea').value += text;
     console
.log('Text pasted.');
   
} catch (error) {
     console
.log('Failed to read clipboard. Using execCommand instead.');
     document
.querySelector('textarea').focus();
     
const result = document.execCommand('paste')
     console
.log('document.execCommand result: ', result);
   
}
});

Leia mais

Demonstração

<!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 text</title>
 
</head>
 
<body>
   
<h1>How to paste text</h1>
   
<p>
     
<button type="button">Paste</button>
   
</p>
   
<textarea></textarea>
 
</body>
</html>

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

       
const pasteButton = document.querySelector('button');

pasteButton
.addEventListener('click', async () => {
 
try {
   
const text = await navigator.clipboard.readText()
    document
.querySelector('textarea').value += text;
    console
.log('Text pasted.');
 
} catch (error) {
    console
.log('Failed to read clipboard. Using execCommand instead.');
    document
.querySelector('textarea').focus();
   
const result = document.execCommand('paste')
    console
.log('document.execCommand result: ', result);
 
}
});