aboutsummaryrefslogtreecommitdiff
path: root/files/ja/web/api/mouseevent/initmouseevent/index.md
blob: 9305047d2099d923fc882a2c4c828eca0c6c3d82 (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
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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
---
title: MouseEvent.initMouseEvent()
slug: Web/API/MouseEvent/initMouseEvent
tags:
  - API
  - DOM
  - DOM イベント
  - 非推奨
  - メソッド
  - MouseEvent
  - リファレンス
browser-compat: api.MouseEvent.initMouseEvent
translation_of: Web/API/MouseEvent/initMouseEvent
---
{{APIRef("DOM Events")}}{{deprecated_header}}

**`MouseEvent.initMouseEvent()`** メソッドは、いったん(通常は {{domxref("Document.createEvent()")}} メソッドで)生成されたマウスイベントの値を初期化します。

> **Warning:** このメソッドは非推奨になったので、今後は使用しないでください。
>
> 代わりに {{domxref("MouseEvent.MouseEvent", "MouseEvent()")}} など、特定のイベントのコンストラクターを使用してください。
> [イベントの作成と起動](/ja/docs/Web/Events/Creating_and_triggering_events)のページに、使用方法についての詳しい情報があります。

この方法で初期化されるイベントは、 {{domxref("Document.createEvent()")}} メソッドで作成されたものでなければなりません。
このメソッドは、 {{domxref("EventTarget.dispatchEvent()")}} を使用してイベントが配信される前に、イベントを設定するために呼び出す必要があります。

## 構文

```js
event.initMouseEvent(type, canBubble, cancelable, view,
                     detail, screenX, screenY, clientX, clientY,
                     ctrlKey, altKey, shiftKey, metaKey,
                     button, relatedTarget);
```

### 引数

- `type`
  - : このイベントの種別 ({{domxref("Event.type", "type")}}) を設定する文字列です。
    マウスイベントで使用可能な種別には、 `click`, `mousedown`,
    `mouseup`, `mouseover`, `mousemove`,
    `mouseout` があります。
- `canBubble`
  - : このイベントがバブリングできるかどうかです。 {{domxref("Event.bubbles")}} の値を設定します。
- `cancelable`
  - : このイベントの既定のアクションを止めることができるかどうかです。
    {{domxref("Event.cancelable")}} の値を設定します。
- `view`
  - : このイベントの AbstractView です。ここでは {{domxref("window")}} オブジェクトを渡す必要があります。
    {{domxref("UIEvent.view")}} の値を設定します。
- `detail`
  - : このイベントのマウスクリック回数です。 {{domxref("UIEvent.detail")}} の値を設定します。
- `screenX`
  - : このイベントのスクリーン X 座標です。
    {{domxref("MouseEvent.screenX")}} の値を設定します。
- `screenY`
  - : このイベントのスクリーン Y 座標です。
    {{domxref("MouseEvent.screenY")}} の値を設定します。
- `clientX`
  - : このイベントのクライアント X 座標です。
    {{domxref("MouseEvent.clientX")}} の値を設定します。
- `clientY`
  - : このイベントのクライアント Y 座標です。
    {{domxref("MouseEvent.clientY")}} の値を設定します。
- `ctrlKey`

  - : このイベント中に <kbd>control</kbd> キーが押されていたかどうか。
    {{domxref("MouseEvent.ctrlKey")}} の値を設定します。

- `altKey`

  - : このイベント中に <kbd>alt</kbd> キーが押されていたかどうか。
    {{domxref("MouseEvent.altKey")}} の値を設定します。

- `shiftKey`

  - : このイベント中に <kbd>shift</kbd> キーが押されていたかどうか。
    {{domxref("MouseEvent.shiftKey")}} の値を設定します。

- `metaKey`

  - : このイベント中に <kbd>meta</kbd> キーが押されていたかどうか。
    {{domxref("MouseEvent.metaKey")}} の値を設定します。

- `button`
  - : このイベントのマウスボタン ({{domxref("MouseEvent.button", "button")}})。
- `relatedTarget`
  - : このイベントに[関連する EventTarget](/ja/docs/Web/API/MouseEvent/relatedTarget)。
    一部のイベント種別 (例えば `mouseover``mouseout`) でのみ使用されます。
    それ以外の場合は `null` を渡してください。

## 例

### HTML

```html
<div style="background:red; width:180px; padding:10px;">
  <div id="out"></div>
  <input type="text">
</div>
```

### JavaScript

```js
document.body.onclick = function(){
  e = arguments[0];
  var dt = e.target,stag = dt.tagName.toLowerCase();
  document.getElementById("out").innerHTML = stag;
};

var simulateClick = function(){
  var evt = document.createEvent("MouseEvents");
  evt.initMouseEvent("click", true, true, window, 0, 0, 0, 80, 20, false, false, false, false, 0, null);
  document.body.dispatchEvent(evt);
}

simulateClick();
```

### 結果

{{EmbedLiveSample('Example')}}

## 仕様書

この機能は仕様書に含まれていません。標準化路線から外れました。

代わりに {{domxref("MouseEvent.MouseEvent", "MouseEvent()")}} コンストラクターを使用してください。

## ブラウザーの互換性

{{Compat}}

## 関連情報

- {{domxref("MouseEvent.MouseEvent()","MouseEvent()")}} コンストラクター:
  {{domxref("MouseEvent")}} を生成するための新しい標準の方法
- {{domxref("Event.initEvent()")}} は似た目的を実現するより単純なメソッドです。
  こちらも廃止されており、使用するべきではありません。