Window：scrollY 属性

值

一个双精度浮点值，表示文档当前相对原点垂直滚动的像素数；正值表示内容向下滚动（以露出底部更多内容）。更技术地说，scrollY 返回当前视口上边缘的 Y 坐标。如果文档完全没有上下滚动，则 scrollY 为 0。如果没有视口，返回值为 0。如果文档在亚像素精确的设备上渲染，则返回值也是亚像素精确的，并且可能包含小数部分。

Safari 会通过将 scrollY 更新到超出最大滚动位置来响应过度滚动（除非默认的“回弹”效果被禁用，例如通过将 overscroll-behavior 设为 none），而 Chrome 和 Firefox 则不会。例如，在 Safari 上，当文档已位于顶部时继续向上滚动，scrollY 可能变为负数。

此属性为只读。要将窗口滚动到特定位置，请使用 Window.scroll()。

示例

// 确保滚动到第二页
if (window.scrollY) {
  window.scroll(0, 0); // 将滚动位置重置到文档的左上角。
}

window.scrollByPages(1);

说明

在使用诸如 scrollBy()、scrollByLines() 或 scrollByPages() 等相对滚动函数时，可用此属性检查文档是否尚未被滚动。

pageYOffset 属性是 scrollY 属性的别名。这意味着如果你没有重新赋值这两个属性中的任一属性，则 window.pageYOffset === window.scrollY 始终为真。

规范

浏览器兼容性

参见

• window.scrollX