aboutsummaryrefslogtreecommitdiff
path: root/files/ja/web/api/window/captureevents/index.html
blob: 72c4cc67d4e066060b1776c7266f5ece253df73a (plain)
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
---
title: Window.captureEvents()
slug: Web/API/Window/captureEvents
tags:
  - API
  - Gecko
  - HTML DOM
  - Method
  - Non-standard
translation_of: Web/API/Window/captureEvents
---
<div>{{ ApiRef() }} {{Deprecated_Header}} {{Non-standard_header}}</div>

<p><code><strong>Window.captureEvents()</strong></code> メソッドは、指定した種類のすべてのイベントをキャプチャするように、そのウィンドウを登録します。</p>

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

<pre class="brush: js">window.captureEvents(<em>eventType</em>)
</pre>

<p><code>eventType</code> は、 <code>Event.ABORT</code>, <code>Event.BLUR</code>, <code>Event.CLICK</code>, <code>Event.CHANGE</code>, <code>Event.DBLCLICK</code>, <code>Event.DRAGDDROP</code>, <code>Event.ERROR</code>, <code>Event.FOCUS</code>, <code>Event.KEYDOWN</code>, <code>Event.KEYPRESS</code>, <code>Event.KEYUP</code>, <code>Event.LOAD</code>, <code>Event.MOUSEDOWN</code>, <code>Event.MOUSEMOVE</code>, <code>Event.MOUSEOUT</code>, <code>Event.MOUSEOVER</code>, <code>Event.MOUSEUP</code>, <code>Event.MOVE</code>, <code>Event.RESET</code>, <code>Event.RESIZE</code>, <code>Event.SELECT</code>, <code>Event.SUBMIT</code>, <code>Event.UNLOAD</code> の値の組み合わせを取ります。</p>

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

<pre class="brush:html">&lt;!DOCTYPE html&gt;
&lt;html lang="en"&gt;
&lt;head&gt;
&lt;!-- ... --&gt;
&lt;script&gt;
function reg() {
  window.captureEvents(Event.CLICK);
  window.onclick = page_click;
}

function page_click() {
  alert('ページクリックイベントが検出されました!');
}
&lt;/script&gt;
&lt;/head&gt;

&lt;body onload="reg();"&gt;
&lt;p&gt;click anywhere on this page.&lt;/p&gt;
&lt;/body&gt;
&lt;/html&gt;
</pre>

<h3 id="Notes"></h3>

<p>ユーザーの操作によって DOM 内で発生したイベント (ボタンのクリックや現在の文書からのフォーカス移動など) は、通常、イベントを開始したオブジェクトに到達する前に、まず高レベルの <a href="/ja/docs/Web/API/Window"><code>window</code></a><a href="/ja/docs/Web/API/Document"><code>document</code></a> オブジェクトを通過します。</p>

<p><a href="/en-US/docs/Web/API/Window"><code>window</code></a><code>captureEvents()</code> メソッドを呼び出すと、指定した種類のイベント (例えば <code>Event.CLICK</code>) は、階層内の「下位」オブジェクトに通過しなくなります。イベントを通常のように「バブルアップ」させるためには、 <a href="/en-US/docs/Web/API/Window/releaseEvents"><code>window.releaseEvents()</code></a> ({{deprecated_inline}}) を window 上で呼び出し、イベントをトラップしないようにしなければなりません。</p>

<p>なお、次の構文を使用することでこのメソッドにイベントのリストを渡すことができます。
  <code>window.captureEvents(Event.KEYPRESS | Event.KEYDOWN | Event.KEYUP)</code>.</p>

<h2 id="Specifications">仕様書</h2>

<p>どの仕様書にも含まれていません。</p>