files/ja/web/api/htmlelement/onpaste/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

---
title: HTMLElement.onpaste
slug: Web/API/HTMLElement/onpaste
tags:
  - API
  - API
  - HTMLElement
  - HTMLElement
  - イベントハンドラー
  - イベントハンドラー
  - プロパティ
  - プロパティ
  - リファレンス
  - 標準外
translation_of: Web/API/HTMLElement/onpaste
---
<div>{{ APIRef("HTML DOM") }} {{Non-standard_header}}</div>

<p><strong>onpaste</strong> プロパティは、現在の要素の onPaste イベントハンドラーを返します。 {{event("paste")}} の W3C 草稿を参照してください。</p>

<h2 id="Syntax" name="Syntax">構文</h2>

<pre class="syntaxbox"><em>element</em>.onpaste = <em>functionRef</em>;</pre>

<p>ここでの <em>functionRef</em> は関数です。それはたいてい、他の場所で宣言された関数の名前、あるいは <em>function 式</em>です。詳しくは <a href="/ja/docs/Web/JavaScript/Reference/Global_Objects/Function">JavaScript リファレンス:Functions</a> を参照してください。</p>

<h2 id="Example" name="Example">例</h2>

<pre class="brush:html">&lt;!DOCTYPE html&gt;
&lt;html&gt;
&lt;head&gt;
&lt;title&gt;onpaste event example&lt;/title&gt;
&lt;/head&gt;

&lt;body&gt;
&lt;h1&gt;Play with this editor!&lt;/h1&gt;
&lt;textarea id="editor" rows="3" cols="80"&gt;
Try pasting text into this area!
&lt;/textarea&gt;

&lt;script&gt;
function log(txt) {
  document.getElementById("log").appendChild(document.createTextNode(txt + "\n"));
}

function pasteIntercept(evt) {
  log("Pasting!");
}

document.getElementById("editor").addEventListener("paste", pasteIntercept, false);
&lt;/script&gt;

&lt;h2&gt;Log&lt;/h2&gt;
&lt;textarea rows="15" cols="80" id="log" readonly="true"&gt;&lt;/textarea&gt;
&lt;/body&gt;
&lt;/html&gt;</pre>

<p>この例は、テキストエリアへの貼り付けのログを表示します。</p>

<h2 id="Notes" name="Notes">メモ</h2>

<p>このイベントは、ユーザがテキストを貼り付けしようとしたときに発生します。</p>

<p>Firefox 13 から、この機能は設定 <code>dom.event.clipboardevents.enabled</code> で制御されます。既定値は <code>true</code> ですが無効化できます。</p>

<h2 id="Specification" name="Specification">仕様書</h2>

<p>仕様の一部ではありません。</p>

<h2 id="Notes_2" name="Notes_2">メモ</h2>

<p>現在、 DOM だけでペーストされたテキストを得る方法はありません。その情報を得るためには {{ Interface("nsIClipboard") }} を用いる必要があります。</p>

<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの対応</h2>

<p class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力したいのであれば、 <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</p>

<p>{{Compat("api.HTMLElement.onpaste")}}</p>

<h2 id="See_also" name="See_also">関連情報</h2>

<ul>
 <li>{{event("paste")}}</li>
 <li>{{domxref("HTMLElement.oncopy")}}</li>
 <li>{{domxref("HTMLElement.oncut")}}</li>
</ul>