From d587eeb68e38d139cef6ac3709d748954a4ce2c8 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Fri, 31 Dec 2021 23:52:09 +0900 Subject: 2021/09/15 時点の英語版に同期 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- files/ja/web/api/mouseevent/mouseevent/index.md | 229 ++++++++++-------------- 1 file changed, 93 insertions(+), 136 deletions(-) diff --git a/files/ja/web/api/mouseevent/mouseevent/index.md b/files/ja/web/api/mouseevent/mouseevent/index.md index ee410e9c65..b33c948bea 100644 --- a/files/ja/web/api/mouseevent/mouseevent/index.md +++ b/files/ja/web/api/mouseevent/mouseevent/index.md @@ -3,146 +3,105 @@ title: MouseEvent() slug: Web/API/MouseEvent/MouseEvent tags: - API - - Constructor + - コンストラクター - DOM - MouseEvent - - Reference - - events + - リファレンス + - イベント +browser-compat: api.MouseEvent.MouseEvent translation_of: Web/API/MouseEvent/MouseEvent --- -

{{APIRef("DOM Events")}}

- -

MouseEvent() コンストラクタは、新しい {{domxref("MouseEvent")}} を作成します。

- -

シンタックス

- -
 event = new MouseEvent(typeArg, mouseEventInit);
- -

値

- -
-
typeArg
-
イベント名を表す {{domxref("DOMString")}} です。
-
mouseEventInit {{optional_inline}}
-
- -
-
Is a MouseEventInit dictionary, having the following fields: - -
    -
  • "screenX", optional and defaulting to 0, of type long, that is the horizontal position of the mouse event on the user's screen; setting this value doesn't move the mouse pointer.
    • -
  • "screenY", optional and defaulting to 0, of type long, that is the vertical position of the mouse event on the user's screen; setting this value doesn't move the mouse pointer.
    • -
  • "clientX", optional and defaulting to 0, of type long, that is the horizontal position of the mouse event on the client window of user's screen; setting this value doesn't move the mouse pointer.
    • -
  • "clientY", optional and defaulting to 0, of type long, that is the vertical position of the mouse event on the client window of the user's screen; setting this value doesn't move the mouse pointer.
    • -
  • "ctrlKey", optional and defaulting to false, of type {{jsxref("Boolean")}}, that indicates if the ctrl key was simultaneously pressed.
    • -
  • "shiftKey", optional and defaulting to false, of type {{jsxref("Boolean")}}, that indicates if the shift key was simultaneously pressed.
    • -
  • "altKey", optional and defaulting to false, of type {{jsxref("Boolean")}}, that indicates if the alt key was simultaneously pressed.
    • -
  • "metaKey", optional and defaulting to false, of type {{jsxref("Boolean")}}, that indicates if the meta key was simultaneously pressed.
    • -
  • "button", optional and defaulting to 0, of type short, that describes which button is pressed during events related to the press or release of a button: - - - - - - - - - - - - - - - - - - - - - -
    ValueMeaning
    0Main button pressed (usually the left button) or un-initialized
    1Auxiliary button pressed (usually the middle button)
    2Secondary button pressed (usually the right button)
    -
    • -
  • "buttons", optional and defaulting to 0, of type unsigned short, that describes which buttons are pressed when the event is launched: - - - - - - - - - - - - - - - - - - - - - - - - - -
    Bit-field valueMeaning
    0No button pressed
    1Main button pressed (usually the left button)
    2Secondary button pressed (usually the right button)
    4Auxiliary button pressed (usually the middle button)
    -
    • -
  • "relatedTarget", optional and defaulting to null, of type {{domxref("EventTarget")}}, that is the element just left (in case of  a {{event("mouseenter")}} or {{event("mouseover")}}) or is entering (in case of a {{event("mouseout")}} or {{event("mouseleave")}}).
    • -
  • "region", optional and defaulting to null, of type {{domxref("DOMString")}}, is the id of the hit region affected by the event. The absence of any hit region is affected, is represented by the null value.
    • -
- -

実装によっては、スクリーンとクライアントのフィールドに数値以外のものを渡すと TypeError がスローされます。

- -
-

MouseEventInit ディクショナリは、{{domxref("UIEvent.UIEvent", "UIEventInit")}} や {{domxref("Event.Event", "EventInit")}} ディクショナリのフィールドも受け入れます。

-
-
-
- -

仕様

- - - - - - - - - - - - - - - - - - - - - -
仕様書ステータスコメント
{{SpecName('CSSOM View', '#extensions-to-the-mouseevent-interface', 'MouseEvent')}}{{Spec2('CSSOM View')}}画面とクライアントのフィールド long を double に再定義しました。
{{SpecName('DOM3 Events','#interface-MouseEvent','MouseEvent()')}}{{Spec2('DOM3 Events')}}初期定義
- -

ブラウザの互換性

- -

{{Compat("api.MouseEvent.MouseEvent")}}

- -

ポリフィル

- -

Internet Explorer 9 以降の MouseEvent() コンストラクタ機能は、以下のコードでポリフィルすることができます。

- -
(function (window) {
+{{APIRef("DOM Events")}}
+
+**`MouseEvent()`** コンストラクターは、新しい {{domxref("MouseEvent")}} を生成します。
+
+## 構文
+
+```js
+ event = new MouseEvent(typeArg, mouseEventInit);
+```
+
+### 値
+
+- _typeArg_
+  - : {{domxref("DOMString")}} で、イベントの名前を表します。
+- _mouseEventInit_ {{optional_inline}}
+
+  - : `MouseEventInit` ディクショナリーで、以下のフィールドを持ちます。
+
+    - `"screenX"`, 省略可能な `long`, 既定値は `0`,
+      ユーザーの画面におけるマウスイベントの水平位置です。
+      この値を設定しても、マウスポインターは移動しません。
+    - `"screenY"`, 省略可能な `long`, 既定値は `0`,
+      ユーザーの画面におけるマウスイベントの垂直位置です。
+      この値を設定しても、マウスポインターは移動しません。
+    - `"clientX"`, 省略可能な `long`, 既定値は `0`,
+      ユーザーの画面のクライアントウィンドウにおけるマウスイベントの水平位置です。
+      この値を設定しても、マウスポインターは移動しません。
+    - `"clientY"`, 省略可能な `long`, 既定値は `0`,
+      ユーザーの画面のクライアントウィンドウにおけるマウスイベントの垂直位置です。
+      この値を設定しても、マウスポインターは移動しません。
+    - `"ctrlKey"`, 省略可能な論理値, 既定値は `false`,
+      ctrl キーが同時に押されていたかどうかを示します。
+    - `"shiftKey"`, 省略可能な論理値, 既定値は `false`,
+      shift キーが同時に押されていたかどうかを示します。
+    - `"altKey"`, 省略可能な論理値, 既定値は `false`,
+      alt キーが同時に押されていたかどうかを示します。
+    - `"metaKey"`, 省略可能な論理値, 既定値は `false`,
+      meta キーが同時に押されていたかどうかを示します。
+    - `"button"`, 省略可能な `short`, 既定値は `0`,
+      ボタンの押下や解放に関連するイベント時に、どのボタンが押されたかを示します。
+
+      | 値    | 意味                                                           |
+      | ----- | -------------------------------------------------------------- |
+      | `0`   | 主ボタン（通常は左ボタン）が押された、または初期化されていない |
+      | `1`   | 予備ボタン（通常は中ボタン）が押された                         |
+      | `2`   | 第二ボタン（通常は右ボタン）が押された                         |
+
+    - `"buttons"`, 省略可能な `unsigned short`, 既定値は `0`,
+      イベントが発行されたときに押されたボタンを示します。
+
+      | ビットフィールド値 | 意味                                       |
+      | ------------------ | ------------------------------------------ |
+      | `0`                | ボタンが押されていない                     |
+      | `1`                | 主ボタン（通常は左ボタン）が押されていた   |
+      | `2`                | 第二ボタン（通常は右ボタン）が押されていた |
+      | `4`                | 予備ボタン（通常は中ボタン）が押されていた |
+
+    - `"relatedTarget"`, 省略可能な {{domxref("EventTarget")}}, 既定値は `null`
+      離れた要素
+      ({{domxref("Element/mouseenter_event", "mouseenter")}} や {{domxref("Element/mouseover_event", "mouseover")}} の場合)
+      または、入った要素 ({{domxref("Element/mouseout_event", "mouseout")}} や {{domxref("Element/mouseleave_event", "mouseleave")}} の場合) です。
+    - `"region"`, 省略可能な {{domxref("DOMString")}}, 既定値は `null`,
+      そのイベントによって影響を受けたヒット領域の ID です。
+      影響を受けるヒット領域がない場合は `null` 値で表現されます。
+
+    実装によっては、 screen と client フィールドに数値以外のものを渡すと `TypeError` が発生します。
+
+    > **Note:** `MouseEventInit` ディクショナリーは {{domxref("UIEvent.UIEvent", "UIEventInit")}} および {{domxref("Event.Event", "EventInit")}} のフィールドも受け入れます。
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## ポリフィル
+
+Internet Explorer 9 以降では、以下のコードで `MouseEvent()` コンストラクターの機能を代替することができます。
+
+```js
+(function (window) {
   try {
     new MouseEvent('test');
-    return false; // ポリフィル不要
+    return false; // No need to polyfill
   } catch (e) {
-		// ポリフィルの必要性 - 落下
+		// Need to polyfill - fall through
   }
 
-    // ポリフィル DOM4 MouseEvent
+    // Polyfills DOM4 MouseEvent
 	var MouseEventPolyfill = function (eventType, params) {
 		params = params || { bubbles: false, cancelable: false };
 		var mouseEvent = document.createEvent('MouseEvent');
@@ -170,10 +129,8 @@ translation_of: Web/API/MouseEvent/MouseEvent
 
 	window.MouseEvent = MouseEventPolyfill;
 })(window);
-
+``` -

あわせて参照

+## 関連情報 - +- {{domxref("MouseEvent")}}: 構築するオブジェクトのインターフェイス -- cgit v1.2.3-54-g00ecf