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

HTML DOM MouseEvent pageYプロパティとは?使い方とサンプルコード解説

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

pageYプロパティの主な特徴

  • ドキュメント全体を基準とするため、ページをスクロールしても基準位置が変わりません(clientYはビューポート基準のため、スクロールで値が変化します)
  • 読み取り専用のプロパティです
  • mousemove、click、mousedownなどのマウスイベント発生時にのみ有効な値を持ちます

構文

pageYプロパティの値を参照する構文は以下の通りです。

MouseEventObject.pageY

MouseEvent pageYプロパティの使用例

ここでは、pageYプロパティを使った簡単なミニゲームの例を紹介します。「Start」ボタンを押すとゲームが開始され、マウスカーソルを緑色の安全エリア内で動かしながら、エリアの端まで到達できれば成功。途中で赤色の危険エリアに触れると失敗となる仕組みです。

サンプルコード

<!DOCTYPE html>
<html>
<head>
<title>MouseEvent pageY</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-pageY</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>

このコードでは、mousemoveイベントが発生するたびにevent.pageXとevent.pageYでカーソルの座標を取得し、Y座標が安全範囲(95〜110)内かどうかを判定しています。

実行結果

「Start」ボタンをクリックし、カーソルが緑色(安全)エリア内にある場合

HTML DOM MouseEvent pageYプロパティとは?使い方とサンプルコード解説

「Start」ボタンをクリックし、カーソルが緑色(安全)エリアの端に到達した場合

HTML DOM MouseEvent pageYプロパティとは?使い方とサンプルコード解説

「Start」ボタンをクリックし、カーソルが赤色(危険)エリアに入った場合

HTML DOM MouseEvent pageYプロパティとは?使い方とサンプルコード解説

まとめ

MouseEventのpageYプロパティを使えば、ドキュメントを基準としたマウスポインタのY座標を簡単に取得できます。pageXと組み合わせることで正確なマウス位置の追跡が可能になり、ドラッグ&ドロップ操作、カスタムカーソル、インタラクティブなゲームやツールチップの表示など、さまざまな場面で活用できる便利なプロパティです。

  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戻り値はピクセル単位の数値