CKTIS / HTML
onpaste — controlador do evento de colagem
O atributo onpaste associa código JavaScript à gestão do evento paste. Está disponível em todos os elementos HTML, mas a sua adição não torna um elemento editável.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
onpaste="JavaScript function body"onpaste é um atributo global de gestão de eventos HTML associado ao evento paste. O seu valor contém instruções JavaScript que formam o corpo de uma função, não o nome de um tipo de evento. O atributo, por si só, não torna um elemento editável.
No código do atributo, event é o objeto do evento e this é o elemento que gere o evento. return false cancela a ação predefinida do evento quando este pode ser cancelado; numa colagem normal num campo editável, impede a inserção de texto. Não interrompe a propagação do evento.
O atributo HTML onpaste e a propriedade JavaScript element.onpaste configuram o mesmo mecanismo de gestão: o atributo contém código, enquanto à propriedade é atribuída uma função ou null. Uma nova atribuição à propriedade substitui a função anterior. addEventListener('paste', handler) regista os ouvintes separadamente; utiliza paste, sem o prefixo on.
O exemplo atualiza uma mensagem de estado e bloqueia a colagem predefinida. Requer JavaScript ativo e autorização para executar controladores de eventos inline; uma Content Security Policy pode bloqueá-los. Não construas este código a partir de dados não fidedignos.
Exemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onpaste demo</title>
<label>Paste here: <textarea onpaste="document.getElementById('status').textContent = 'paste handled'; return false;"></textarea></label>
<p id="status" role="status">waiting</p>
</html>Resultado
paste handled
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.