Coordinates

To move elements around we should be familiar with coordinates. Most JavaScript methods deal with one of two coordinate systems: 1. Relative to the window - similar to position:fixed, calculated from the window top/left edge. - we’ll denote these coordinates as clientX/clientY, the reasoning for such name will become clear later, when we study event properties. 2. Relative to the document - similar to position:absolute in the document root, calculated from the document top/left edge. - we’ll denote them pageX/pageY. When the page is scrolled to the very beginning, so that the top/left corner of the window is exactly the document top/left corner, these coordinates equal each other. But after the document shifts, window-relative coordinates of elements change, as elements move across the window, while document-relative coordinates remain the same. On this picture we take a point in the document and demonstrate its coordinates before the scroll (left) and after it (right): When the document scrolled: - pageY - document-relative coordinate stayed the same, it’s counted from the document top (now scrolled out). - clientY - window-relative coordinate did change (the arrow became shorter), as the same point became closer to window top.

Element coordinates: getBoundingClientRect

The method elem.getBoundingClientRect() returns window coordinates for a minimal rectangle that encloses elem as an object of built-in DOMRect class. Main DOMRect properties: - x/y – X/Y-coordinates of the rectangle origin relative to window, - width/height – width/height of the rectangle (can be negative). Additionally, there are derived properties: - top/bottom – Y-coordinate for the top/bottom rectangle edge, - left/right – X-coordinate for the left/right rectangle edge. Here’s the picture of elem.getBoundingClientRect() output: As you can see, x/y and width/height fully describe the rectangle. Derived properties can be easily calculated from them: - left = x - top = y - right = x + width - bottom = y + height Please note: - Coordinates may be decimal fractions, such as 10.5. That’s normal, internally browser uses fractions in calculations. We don’t have to round them when setting to style.left/top. - Coordinates may be negative. For instance, if the page is scrolled so that elem is now above the window, then elem.getBoundingClientRect().top is negative.

elementFromPoint(x, y) [#elementFromPoint]

The call to document.elementFromPoint(x, y) returns the most nested element at window coordinates (x, y). The syntax is: For instance, the code below highlights and outputs the tag of the element that is now in the middle of the window: As it uses window coordinates, the element may be different depending on the current scroll position. let elem = document.elementFromPoint(x, y); // if the coordinates happen to be out of the window, then elem = null elem.style.background = “; // Error!

Using for “fixed” positioning

Most of time we need coordinates in order to position something. To show something near an element, we can use getBoundingClientRect to get its coordinates, and then CSS position together with left/top (or right/bottom). For instance, the function createMessageUnder(elem, html) below shows the message under elem: The code can be modified to show the message at the left, right, below, apply CSS animations to “fade it in” and so on. That’s easy, as we have all the coordinates and sizes of the element. But note the important detail: when the page is scrolled, the message flows away from the button. The reason is obvious: the message element relies on position:fixed, so it remains at the same place of the window while the page scrolls away. To change that, we need to use document-based coordinates and position:absolute.

Document coordinates [#getCoords]

Document-relative coordinates start from the upper-left corner of the document, not the window. In CSS, window coordinates correspond to position:fixed, while document coordinates are similar to position:absolute on top. We can use position:absolute and top/left to put something at a certain place of the document, so that it remains there during a page scroll. But we need the right coordinates first. There’s no standard method to get the document coordinates of an element. But it’s easy to write it. The two coordinate systems are connected by the formula: - pageY = clientY + height of the scrolled-out vertical part of the document. - pageX = clientX + width of the scrolled-out horizontal part of the document. The function getCoords(elem) will take window coordinates from elem.getBoundingClientRect() and add the current scroll to them: If in the example above we used it with position:absolute, then the message would stay near the element on scroll. The modified createMessageUnder function:

Summary

Any point on the page has coordinates: 1. Relative to the window – elem.getBoundingClientRect(). 2. Relative to the document – elem.getBoundingClientRect() plus the current page scroll. Window coordinates are great to use with position:fixed, and document coordinates do well with position:absolute. Both coordinate systems have their pros and cons; there are times we need one or the other one, just like CSS position absolute and fixed.

For instance click this button to see its window coordinates:

<p><input id="brTest" type="button" style="max-width: 90vw;" value="Get coordinates using button.getBoundingClientRect() for this button" onclick='showRect(this)'/></p>

<script>
function showRect(elem) {
  let r = elem.getBoundingClientRect();
  alert(`x:${r.x}
y:${r.y}
width:${r.width}
height:${r.height}
top:${r.top}
bottom:${r.bottom}
left:${r.left}
right:${r.right}
`);
}
</script>

If you scroll the page and repeat, you'll notice that as window-relative button position changes, its window coordinates (`y/top/bottom` if you scroll vertically) change as well.