window.scrollY

概要

文書が垂直スクロールされているピクセル数を返します。

構文

ypix = window.scrollY;

• ypix : 文書の上部からスクロール量（ピクセル）

例

// スクロールしている場合、戻してから次のページへスクロールダウン
if (window.scrollY) {
  scroll(0, 0); //文書の左上にスクロール位置をリセット
}

scrollByPages(1);

注記

window.scrollBy 、window.scrollByLines 、window.scrollByPages のような相対スクロールする関数を使用する際に、文書が既にスクロールしていないかをチェックするためにこのプロパティを使用してください。

pageYOffset プロパティは、scrollY プロパティのエイリアスです。

window.pageYOffset == window.scrollY; // 常に true

クロスブラウザ互換性の為、window.scrollY ではなく window.pageYOffset を使用します。さらに、古いバージョンの Internet Explorer (IE9 以前) は何れもサポートしていないため、チェックの上、無ければ他の非標準の方法で回避する必要があります。以下に互換性を確保した例を示します。

var x = (window.pageXOffset !== undefined) ? window.pageXOffset : (document.documentElement || document.body.parentNode || document.body).scrollLeft,
    y = (window.pageYOffset !== undefined) ? window.pageYOffset : (document.documentElement || document.body.parentNode || document.body).scrollTop;

仕様

現在、標準化作業が進められています。

• CSSOM View Module: window.scrollY (Editor's Draft)

関連情報

• window.scrollX