HTML
 Computer >> コンピューター >  >> プログラミング >> HTML

HTML DOM MouseEventのpageXプロパティとは？使い方を実例付きで解説

HTML DOMのMouseEvent pageXプロパティは、マウスイベントが発生した際に、ドキュメントを基準としたマウスポインタの水平（X）座標を返します。垂直（Y）座標も取得したい場合は、pageYプロパティと組み合わせて使用します。

pageXプロパティの構文

pageXの値を参照するための構文は以下の通りです。

MouseEventObject.pageX

MouseEvent pageXの実装例

ここでは、pageXプロパティを活用した簡単なミニゲームの例を紹介します。このゲームでは、マウスカーソルを緑色の「安全エリア」内で移動させ、指定した座標に到達できれば成功、赤色の「危険エリア」に入ってしまうと失敗となります。マウスの座標取得がどのようにゲームに活用できるかを理解するのに最適なサンプルです。

サンプルコード

<!DOCTYPE html>
<html>
<head>
<title>MouseEvent pageX</title>
<style>
   * {
      padding: 2px;
      margin:5px;
   }
   form {
      width:70%;
      margin: 0 auto;
      text-align: center;
   }
   #outer {
      width:70%;
      margin: 0 auto;
      padding: 0;
      text-align: center;
      border:1px solid black;
      height: 105px;
      background-color: #28a745;
   }
   input[type="button"] {
      border-radius: 10px;
   }
   #upper {
      border-bottom: 1px solid black;
      height: 40px;
      margin: 0 0 15px 0;
      background-color: #DC3545;
   }
   #lower {
      border-top: 1px solid black;
      height: 40px;
      margin: 15px 0 0 0;
      background-color: #DC3545;
   }
</style>
</head>
<body>
   <form>
      <fieldset>
         <legend>MouseEvent-pageX</legend>
         <div id="outer">
         <div id="upper"><h2>Danger</h2></div>
         <div id="lower"><h2>Danger</h2></div>
         </div>
         <input type="button" id="start" value="Start" onclick="gameStart()">
         <div id="divDisplay"></div>
      </fieldset>
   </form>
<script>
   var divDisplay = document.getElementById('divDisplay');
   var gameDisplay = document.getElementById('outer');
   function playGame(event) {
      var x = event.pageX;
      var y = event.pageY;
         if(y > 95 && y < 110){
            divDisplay.textContent = 'Keep Going!';
               if(x === 439){
                  divDisplay.textContent = 'Congrats! You Did it!';
                  gameDisplay.removeEventListener('mousemove', playGame);
               }
         }
         else{
            divDisplay.textContent = 'You moved to DANGER area. You loose!';
            gameDisplay.removeEventListener('mousemove', playGame);
         }
   }
   function gameStart(){
      gameDisplay.addEventListener('mousemove',playGame);
   }
</script>
</body>
</html>

実行結果

「Start」ボタンをクリックし、カーソルが緑色（安全）エリア内にある場合の表示は以下の通りです。

HTML DOM MouseEventのpageXプロパティとは？使い方を実例付きで解説

「Start」ボタンをクリックし、カーソルが緑色（安全）エリアの端に到達した場合の表示は以下の通りです。

HTML DOM MouseEventのpageXプロパティとは？使い方を実例付きで解説

「Start」ボタンをクリックし、カーソルが赤色（危険）エリア内に入った場合の表示は以下の通りです。

HTML DOM MouseEventのpageXプロパティとは？使い方を実例付きで解説

まとめ

pageXプロパティを使うことで、ドキュメント全体を基準としたマウスカーソルの正確な水平位置を取得できます。pageYと併用すれば2次元の座標情報が得られるため、ドラッグ＆ドロップ操作、カスタムカーソル、インタラクティブなゲームなど、さまざまな場面で活用できる重要なプロパティです。

  1. HTML DOMのMouseEvent offsetXプロパティとは？マウス座標の取得方法を解説

    MouseEvent offsetXプロパティとはHTML DOMのMouseEvent offsetXプロパティは、マウスイベントが発生した際に、ターゲット要素を基準としたマウスポインタの水平方向（X軸）の座標を返します。垂直方向（Y軸）の座標を取得したい場合は、offsetYプロパティと組み合わせて使用します。これらのプロパティを活用することで、要素内でのマウスの正確な位置を把握でき、ドラッグ＆ドロップ操作やゲーム、カスタムカーソル追従機能など、さまざまなインタラクティブなWebアプリケーションの実装に役立ちます。構文（シンタックス）offsetXプロパティの値を参照する基本的な構文は以下

  2. HTML DOM MouseEvent clientYプロパティとは？マウスのY座標を取得する方法を解説

    MouseEvent の clientY プロパティは、マウスイベントが発生した際のマウスポインタの縦方向（Y）の座標値を返します。clientX プロパティと組み合わせることで、横方向（X）の座標も同時に取得できます。これらの座標は、ブラウザの表示領域（ビューポート）の左上隅を原点（0,0）とした相対位置で表されます。そのため、画面上でカーソルが現在どの位置にあるのかを正確に把握したい場面、例えばドラッグ＆ドロップの実装やミニゲームの作成などで活躍します。構文clientY の値を参照する基本的な構文は以下の通りです。MouseEventObject.clientY戻り値はピクセル単位の数値