Window: screenY 属性

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 提供填充。

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

规范

规范
CSSOM 视图模块
# dom-window-screeny

浏览器兼容性

BCD 表仅在启用 JavaScript 的浏览器中加载。

另请参阅