Window:screenY 屬性

Baseline 廣泛可用 *

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

* 此特性的某些部分可能存在不同級別的支援。

Window.screenY 只讀屬性返回使用者瀏覽器視口頂部邊框到螢幕頂部的垂直距離(以 CSS 畫素為單位)。

注意: 近年來,在現代瀏覽器中實現了 screenY 的別名 — Window.screenTop。最初這僅在 IE 中受支援,但由於其受歡迎程度,已在所有瀏覽器中引入。

一個等於從瀏覽器視口頂部邊緣到螢幕頂部邊緣的 CSS 畫素數的數字。

示例

在我們 screenleft-screentop 示例中,您將看到一個繪製有圓形的畫布。在此示例中,我們使用 Window.screenLeft/Window.screenTop 以及 Window.requestAnimationFrame(),即使視窗位置移動,也能在螢幕上的同一物理位置不斷重繪圓形。

js
initialLeft = window.screenLeft + canvasElem.offsetLeft;
initialTop = window.screenTop + canvasElem.offsetTop;

function positionElem() {
  let newLeft = window.screenLeft + canvasElem.offsetLeft;
  let newTop = window.screenTop + canvasElem.offsetTop;

  let leftUpdate = initialLeft - newLeft;
  let topUpdate = initialTop - newTop;

  ctx.fillStyle = "rgb(0 0 0)";
  ctx.fillRect(0, 0, width, height);
  ctx.fillStyle = "rgb(0 0 255)";
  ctx.beginPath();
  ctx.arc(
    leftUpdate + width / 2,
    topUpdate + height / 2 + 35,
    50,
    degToRad(0),
    degToRad(360),
    false,
  );
  ctx.fill();

  pElem.textContent = `Window.screenLeft: ${window.screenLeft}, Window.screenTop: ${window.screenTop}`;

  window.requestAnimationFrame(positionElem);
}

window.requestAnimationFrame(positionElem);

這些屬性的工作方式與 screenX/screenY 完全相同。

在程式碼中,我們還包含了一個片段,用於檢測是否支援 screenLeft,如果不支援,則使用 screenX/screenYscreenLeft/screenTop 進行 polyfill。

js
if (!window.screenLeft) {
  window.screenLeft = window.screenX;
  window.screenTop = window.screenY;
}

規範

規範
CSSOM 檢視模組
# dom-window-screeny

瀏覽器相容性

另見