y property

Sets or retrieves the y-coordinate (in pixels) of the mouse pointer, or user's finger, offset from the closest relatively positioned parent element of the element that fired the event.



p = object.y


Property values

Type: Integer

the y-coordinate, in pixels.


The property is read-only in Microsoft Internet Explorer 4.0, and read/write in Microsoft Internet Explorer 5 and later. In browser versions earlier than Internet Explorer 5, the y property retrieves a coordinate relative to the client.

If the event firing element is relatively positioned, then the y-coordinate from the boundary of the element is returned. If the event firing element and all of its parent elements are not relatively positioned, then the y property returns a coordinate relative to the body element.

The y property returns a coordinate relative to the body element.

If the mouse or finger is outside the window at the time the event fires, this property returns -1.


This example displays the current mouse position.

<!DOCTYPE html>

    html, body {
      height: 100%;
      margin: 0;
      padding: 0;
  <div id="outputBox"></div>
    document.getElementsByTagName('body')[0].addEventListener('mousemove', displayPointerPosition, false);

    var outputBox = document.getElementById('outputBox');
    function displayPointerPosition(evt) {
      outputBox.textContent = "(" + evt.x + ", " + evt.y + ")";

See also