Tradução em progresso.
Non-standard
This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.
Sumário
A propriedade onpaste retorna o código do evento onPaste do elemento atual.
Sintaxe
element.onpaste = functionRef;
onde functionRef é uma função - comumente um nome de uma função declarada em outro lugar ou uma function expression. Veja JavaScript Reference:Functions para detalhes.
Exemplo
<!DOCTYPE html>
<html>
<head>
<title>Exemplo do evento onpaste</title>
</head>
<body>
<h1>Brinque com este editor!</h1>
<textarea id="editor" rows="3" cols="80">
Tente colar um texto dentro desta área!
</textarea>
<script>
function log(txt) {
document.getElementById("log").appendChild(document.createTextNode(txt + "\n"));
}
function pasteIntercept(evt) {
log("Colando!");
}
document.getElementById("editor").addEventListener("paste", pasteIntercept, false);
</script>
<h2>Log</h2>
<textarea rows="15" cols="80" id="log" readonly="true"></textarea>
</body>
</html>
Este exemplo registra a colagem dentro do textarea.
Notas
Este evento é disparado quando o usuário tenta colar um texto.
Desde a versão 13 do Firefox, o atributo dom.event.clipboardevents.enabled controla esta feature. O valor padrão é true, mas pode ser desativado.
Especificação
Não faz parte da especificação.
Notas
There is currently no DOM-only way to obtain the text being pasted; you'll have to use an nsIClipboard to get that information.