Edit this page

Scroller Overview

The Hybrid UI Scroller widget enables touch-friendly kinetic scrolling for the contents of a given DOM element.

Getting Started

Each mobile View initializes a scroller for its content element. In addition to that, a scroller is initialized for every element with a role data-attribute set to scroller. Alternatively, a scroller can be initialized using jQuery plugin syntax in the containing mobile View init event handler.

Initialize from Markup

For the scroller to work, its element should have fixed dimensions—width and/or height—set.

The example below demonstrates how to initialize the Hybrid UI Scroller by using the role data-attribute.

Example
<div data-role="scroller">
    Foo
</div>

Initialize Using jQuery

The example below demonstrates how to initialize the Hybrid UI Scroller by using jQuery plugin syntax.s

Example
<div id="scroller"></div>

<script>
    var scroller = $("#scroller").kendoMobileScroller();
</script>

Obtain Current View Scrollers

The example below demonstrates how to obtain the current mobile view scroller.

Example
<div data-role="view" data-init="getScroller">
    Foo
</div>

<script>
    function getScroller(e) {
        var scroller = e.view.scroller;
    }
</script>

Properties

The Hybrid UI Scroller widget exposes the following fields:

  • scrollElement—The inner Scroller element that holds the scrolling content. Use this field if you wish to change the element contents after the Scroller is initialized on it.
  • scrollTop—The number of pixels that are hidden from view above the scrollable area.
  • scrollLeft—The number of pixels that are hidden from view to the left of the scrollable area.

See Also

Other articles and how-to examples on the Hybrid UI components and on the Scroller:

Is this article helpful? Yes / No
Thank you for your feedback!

Give article feedback

Tell us how we can improve this article

close
Dummy