.onpaste

非標準
この機能は非標準であり、標準に沿うものではありません。 全てのユーザー環境で動作するものではないため、製品版としてのWebサイトには使用しないでください。 また、各(ブラウザの)で互換性がなく実装に大きな違いがある可能性があり、 将来的に動作が変更される恐れもあります。

onpasteプロパティは、現在の要素のonPasteイベントハンドラのコードを返します。

文法

element.onpaste = functionRef;

functionRefには宣言した関数の名前、または関数の式を指定します。 詳細は、Function(関数)を参照してください。

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

<body>
<h1>Play with this editor!</h1>
<textarea id="editor" rows="3" cols="80">
このエリアにテキストを貼り付けてください。
</textarea>

<script>
function log(txt) {
  document.getElementById("log").appendChild(document.createTextNode(txt + "\n"));
}

function pasteIntercept(evt) {
  log("貼り付け!");
}

document.getElementById("editor").addEventListener("paste", pasteIntercept, false);
</script>

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

この例では、テキストエリアへの貼り付けの際にログを出力します。

注意事項

このイベントは、ユーザーがテキストの貼り付けを試みた際に送られます。

現在、DOMだけで貼り付けられるテキストの内容を取得する方法は存在しません。 その情報を所得するには、nsIClipboardを使用する必要があります。

仕様

これは仕様の一部ではありません。

関連項目

 Back to top

© 2017 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.

このページは、ページトップのURL先のMozilla Developer Network(以下、MDN)のコンテンツを翻訳した内容を基に構成されています。 構成について異なる点も含まれますので、下記の項目を確認し、必要に応じて元のコンテンツをご確認ください。 もし、誤訳などの間違いを見つけましたら、 @tomofまで教えていただければ幸いです。

  • 特定のブラウザに特化しすぎている情報やあまりにも古い情報、 または試験的に導入されているようなAPIや機能については、省略していることがあります。
  • 例やデモについて、実際にページ内で動作させる関係で一部ソースコードを変更している場合や、 その例で使用しているコンテンツの単語や文章などを日本人向けに変更しいてる場合があります。
  • MDNの更新頻度が高いため、元のコンテンツと比べ情報が古くなっている可能性があります。
  • "訳注:"などの断わりを入れた上で、日本人向けの情報の追記を行っている事があります。