Window:screenTop 属性

Baseline 广泛可用 *

此功能已成熟,并可在许多设备和浏览器版本上运行。自 2018 年 12 月起,所有浏览器均支持此功能。

* 此特性的某些部分可能存在不同级别的支持。

Window.screenTop 只读属性返回用户浏览器视口顶部边框到屏幕顶部之间的垂直距离(以 CSS 像素为单位)。

注意: screenTop 是旧的 Window.screenY 属性的别名。screenTop 最初仅在 IE 中支持,但由于其受欢迎程度,后来被引入到所有浏览器中。

一个数值,等于浏览器视口顶部边缘到屏幕顶部边缘之间的 CSS 像素数量。

示例

在我们 screenleft-screentop 示例中,您会看到一个绘制了圆形的 canvas。在此示例中,我们使用 screenLeft/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);

在代码中,我们还包含了一个代码片段,用于检测是否支持 screenLeft,如果不支持,则使用 Window.screenX/ Window.screenYscreenLeft/screenTop 提供 polyfill。

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

规范

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

浏览器兼容性

另见