element.scrollTop

Podsumowanie

scrollTop pobiera bądź ustawia liczbę pikseli, o którą ma zostać przewinięta w górę zawartość elementu.

Składnia i wartości

// Pobierz wartość przewinięcia w pikselach
var  intElemScrollTop = element.scrollTop;

intElemScrollTop jest liczbą całkowitą reprezentującą ilość pikseli, o które element został przewinięty w górę.

// Ustaw wartość przewinięcia w pikselach
element.scrollTop = intValue;

scrollTop może przyjąć dowolną wartość liczbową, jednakże:

• Jeżeli element nie może być przewijany (gdy np. nie posiada własności overflow), scrollTop jest równe 0.
• Jeżeli ustawiona wartość jest mniejsza niż 0, scrollTop jest równe 0.
• Jeżeli ustawiona wartość jest większa od wartości maksymalnej, o którą zawartość elementu może być przewinięta, scrollTop jest równe wartości maksymalnej.

Opis

Element scrollTop jest miarą odległości od góry elementu do najwyższej krawędzi jego widzialnej zawartości.

Kiedy zawartość elementu nie powoduje powstania pionowego paska przewijania, wartość scrollTop jest domyślnie ustawiona na 0.

Przykład

Nie mamy interaktywnej demonstracji jak ma to miejsce w dokumentacji Gecko DOM.

Specyfikacja

scrollTop jest częścią obiektowego modelu MSIE DHTML . scrollTop nie jest częścią żadnej specyfikacji W3C lub rekomendacji technicznej.

Uwagi

scrollTop jest własnością obiektowego modelu DHTML , który po raz pierwszy został wprowadzony przez MSIE. Własność ta jest zdefiniowana jako odległość do górnej krawędzi widoku elementu przewijanego.

Dokumentacja

• MSDN's scrollTop definition
• MSDN's Measuring Element Dimension and Location
• Gecko DOM Reference on scrollTop