Scroll Panel

NOTE: Scroll Panels are only available in the "next" branch scheduled for release in v0.9.3

NOTE: Scroll Panels are only supported on BlackBerry 10 and PlayBook

Scroll panels allow you to specify an panel on your screen where the contents of the panel will scroll. This is typically used in creating either a master/detail style view (as seen in the picture above) or for creating fixed areas on your screen that have scrollable areas.

A scrolling panel is a <div> with a data-bb-type="scroll-panel" attribute. NOTE: In order for content to scroll in the panel, it must have a specified height. Otherwise the panel will grow to the size of its inner content

    <div data-bb-type="scroll-panel" style="height:450px">
           <!-- Some content -->
    </div>

JavaScript Interface

If you have manipulated the content of the scrolling panel via JavaScript you will want to call refresh() so that it can recalculate its scrolling dimentions

    document.getElementById('myScrollingPanel').refresh();

You can also scroll to a specific x,y coordinate by using the scrollTo() function. It takes both an x and y coordinate as well as an optional time parameter in milliseconds to animate the scroll. If no animation is desired then time should be omitted or specified as 0.

    document.getElementById('myScrollingPanel').scrollTo(0,100,250);

If you want to scroll relative to the current scroll position (i.e. scroll 10 pixels down) then you can specify true for the relative parameter.

    document.getElementById('myScrollingPanel').scrollTo(0, 10, 20, true);    

If you have an element in the scrolling panel that you would like to scroll to, you can use the scrollToElement() function. This function takes in the element to scroll to and an optional time parameter for how long you want the animation to last.

    var element = document.getElementById('myitem');
    document.getElementById('myScrollingPanel').scrollToElement(element, 100);