Window 인터페이스인 scrollY 읽기전용 속성은 문서가 수직으로 몇 픽셀만큼 스크롤되었는지를 반환합니다. 반환되는 값은 최신 브라우저에서 subpixel 정밀도이므로 반드시 정수값이 반환되는 것은 아닙니다. 수평으로 스크롤된 픽셀수치는 scrollX 속성을 사용하여 가져올 수 있습니다.

Syntax

var y = window.scrollY

Value

실제로 반환되는 값은 문서가 원점으로부터 수직방향으로 스크롤되는 픽셀의 수를 나타내는 배정밀도 부동소수점 값이며,
여기서 양수값은 내용이 위쪽으로 스크롤된 것을 의미합니다.
만약 문서가 subpixel 정밀 장치에서 렌더링 되었을 경우, 반환값은 subpixel 정밀도이며 소수 요소를 포함할 수도 있습니다.
만약 문서가 위쪽이나 아래쪽이나 스크롤되지 않으면 scrollY 의 값은 0 입니다.

만약 정수값을 반환받기를 원한다면 Math.round()를 사용하여 반올림 할 수 있습니다.

더 전문적인 용어로,  scrollY 는 현재 viewport의 위쪽 가장자리의 Y좌표를 반환합니다.
만약 뷰포트가 없다면, 0이 반환됩니다.

Example

// make sure and go down to the second page 
if (window.scrollY) {
  window.scroll(0, 0);  // reset the scroll position to the top left of the document.
}

window.scrollByPages(1);

Notes

이 속성을 사용하여 scrollBy(), scrollByLines(), 또는 scrollByPages()와 같은 상대 스크롤 함수를 사용할 때 문서가 아직 스크롤되지 않았는지 체크합니다.

pageYOffset 속성은 scrollY 의 alias 입니다:

window.pageYOffset == window.scrollY; // always true

브라우저 호환성을 위해, window.scrollY 대신 window.pageYOffset 을 사용하십시오 . 추가로, 이전 버전의 Internet Explorer ( < 9 ) 두가지의 속성을 모두 지원하지 않으므로
다른 비표준 속성을 사용하여 해결해야 합니다.

완벽히 호환되는 코는 예제:

var supportPageOffset = window.pageXOffset !== undefined;
var isCSS1Compat = ((document.compatMode || "") === "CSS1Compat");

var x = supportPageOffset ? window.pageXOffset : isCSS1Compat ? document.documentElement.scrollLeft : document.body.scrollLeft;
var y = supportPageOffset ? window.pageYOffset : isCSS1Compat ? document.documentElement.scrollTop : document.body.scrollTop;

Specification

Specification Status Comment
CSS Object Model (CSSOM) View Module
The definition of 'window.scrollY' in that specification.
Working Draft  

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Microsoft Edge Opera Safari (WebKit)
Basic support (Yes) (Yes) No support (Yes) (Yes) (Yes)
Subpixel precision ? 55 (55) No support ? ? ?
Feature Android Android Webview Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support ? (Yes) (Yes) ? ? ? ? (Yes)
Subpixel precision ? (Yes) 55.0 (55) ? ? ? ? (Yes)

See also

문서 태그 및 공헌자

 이 페이지의 공헌자: jeonnoej
 최종 변경: jeonnoej,