Element.onpaste

Summary

The onpaste property returns the onPaste event handler code on the current element.

Syntax

element.onpaste = functionRef;

where functionRef is a function - often a name of a function declared elsewhere or a function expression. See JavaScript Reference:Functions for details.

Example

<!DOCTYPE html>
<html>
<head>
<title>onpaste event example</title>
</head>

<body>
<h1>Play with this editor!</h1>
<textarea id="editor" rows="3" cols="80">
Try pasting text into this area!
</textarea>

<script>
function log(txt) {
  document.getElementById("log").appendChild(document.createTextNode(txt + "\n"));
}
  
function pasteIntercept(evt) {
  log("Pasting!");
}
  
document.getElementById("editor").addEventListener("paste", pasteIntercept, false);
</script>

<h2>Log</h2>
<textarea rows="15" cols="80" id="log" readonly="true"></textarea>
</body>
</html>

This example logs pastes into a textarea.

Notes

This event is sent when the user attempts to paste text.

Specification

Not part of specification.

Notes

There is currently no DOM-only way to obtain the text being pasted; you'll have to use an nsIClipboard to get that information.

See also

Document Tags and Contributors

Contributors to this page: Sheppy, ziyunfei, nairakhil13, ethertank, kscarfone, Mgjbot, Potappo
Last updated by: kscarfone,