Evento onpaste

Definição e uso

O evento onpaste ocorre quando o usuário cola conteúdo em um elemento.

Embora todos os elementos HTML suportem o evento onpaste, não é possível colar conteúdo em elementos como <p>, a menos que o elemento tenha o contenteditable configurado como "true" (veja mais exemplos abaixo).

Dica: O evento onpaste é usado principalmente para elementos <input> do tipo "text".

Dica:Conteúdo pode ser colado em um elemento de três maneiras:

  • CTRL + V
  • Escolha Colar no menu de edição do navegador
  • Selecione o comando Colar no menu de contexto

Exemplo

Exemplo 1

Execute JavaScript ao colar texto em um elemento <input>:

<input type="text" onpaste="myFunction()" value="Clique aqui para colar">

Experimente você mesmo

Exemplo 2

Execute JavaScript ao colar texto em um elemento <p> (observe que contenteditable foi configurado como "true"):

<p contenteditable="true" onpaste="myFunction()">Tente colar algo dentro deste parágrafo.</p>

Experimente você mesmo

Sintaxe

No HTML:

<elemento onpaste="myScript">

Experimente você mesmo

No JavaScript:

objeto.onpaste = function(){myScript};

Experimente você mesmo

No JavaScript, use o método addEventListener():

objeto.addEventListener("paste", myScript);

Experimente você mesmo

Comentário:O Internet Explorer 8 ou versões anteriores não suportam Método addEventListener()

Detalhes técnicos

P冒泡: Suporte
Cancelável: Suporte
Tipo de evento: ClipboardEvent
Tags HTML suportadas: Todos os elementos HTML

Suporte do navegador

Eventos Chrome IE Firefox Safari Opera
onpaste Suporte Suporte Suporte Suporte Suporte

Páginas relacionadas

Manual de referência do HTML DOM:Evento oncopy

Manual de referência do HTML DOM:Evento oncut