mozilla
Your Search Results

    DOM:element.scrollTop

    « DOM Reference

    Summary

    scrollTop gets or sets the number of pixels that the content of an element is scrolled upward.

    Syntax and values

    // Get the number of pixels scrolled
    var  intElemScrollTop = element.scrollTop;
    

    intElemScrollTop is an integer corresponding to number of pixels that element's content has been scrolled upward.

    // Set the number of pixels scrolled
    element.scrollTop = intValue;
    

    scrollTop can be set to any integer value, however:

    • If the element can't be scrolled (e.g. it has no overflow or if the element is non-scrollable), scrollTop is set to 0.
    • If set to a value less than 0, scrollTop is set to 0.
    • If set to a value greater than the maximum that the content can be scrolled, scrollTop is set to the maximum.

    Description

    An element's scrollTop is a measurement of the distance of an element's top to its topmost visible content.

    When an element content does not generate a vertical scrollbar, then its scrollTop value defaults to 0.

    Example

    padding-top

    Gentle, individualistic and very loyal, Birman cats fall between Siamese and Persian in character. If you admire cats that are non aggressive, that enjoy being with humans and tend to be on the quiet side, you may well find that Birman cats are just the felines for you.

    Image:BirmanCat.jpgAll Birmans have colorpointed features, dark coloration of the face, ears, legs and tail.

    Cat image and text coming from www.best-cat-art.com

    padding-bottom

    LeftTopRightBottommargin-topmargin-bottomborder-topborder-bottom[if IE]><span id="MrgLeft" style="position: _fckstyle="position: absolute; left: 8px; top: 65px; font: bold 13px Arial, sans-serif !important; writing-mode: tb-rl;">margin-left</span><span id="BrdLeft" style="position: absolute; left: 33px; top: 65px; color: white; font: bold 13px Arial, sans-serif !important; writing-mode: tb-rl;">border-left</span><span id="PdgLeft" style="position: absolute; left: 55px; top: 65px; font: bold 13px Arial, sans-serif !important; writing-mode: tb-rl;">padding-left</span><span id="PdgRight" style="position: absolute; left: 275px; top: 60px; color: black; font: bold 13px Arial, sans-serif !important; writing-mode: tb-rl; white-space: nowrap;">padding-right</span><span id="BrdRight" style="position: absolute; left: 310px; top: 65px; color: white; font: bold 13px Arial, sans-serif !important; writing-mode: tb-rl;">border-right</span><span id="MrgRight" style="position: absolute; left: 340px; top: 65px; font: bold 13px Arial, sans-serif !important; writing-mode: tb-rl;">margin-right</span><![endif]

    Image:scrollTop.png

    Specification

    scrollTop is part of the MSIE's DHTML object model and is implemented in the Mozilla Gecko engine powering Firefox.

    scrollTop is also part of a draft specification from the W3C's CSS working group.

    Notes

    scrollTop is a property of the DHTML object model which was first introduced by MSIE. It is referred as the distance to the top of an element physical scrolling view.

    References

    Document Tags and Contributors

    Contributors to this page: Anonymous
    Last updated by: Anonymous,