YUI Library Examples: ScrollView: Horizontal ScrollView

ScrollView: Horizontal ScrollView

A Horizontal ScrollView

In this example, we'll create a ScrollView instance, which scrolls horizontally, as opposed to the vertically scrolling ScrollView we created in the ScrollView With Scroll Indicator example.

The code for the example is pretty much the same as the code for the ScrollView With Scroll Indicator example. The only difference is that instead of having a ScrollView with a fixed height (and content which overflows that height), we set up a ScrollView with a fixed width (and content which overflows that width).

Modules Used

Since we want to use the base ScrollView, along with the ScrollViewScrollbars plugin, we use the scrollview module as we did for the vertical ScrollView example:

YUI().use('scrollview', function(Y) {
    ...
});
 

YUI().use('scrollview', function(Y) {
    ...
});
 

Instantiating The ScrollView Widget

As with the vertical ScrollView example, we provide the markup for the ScrollView content on the page, as shown below:

<!-- Content with a width which would require scrolling -->
<div id="scrollable" style="" class="yui3-scrollview-loading horiz">
    <ul>
        <li><img src="..."></li>
        <li><img src="..."></li>
        <li><img src="..."></li>
        <li><img src="..."></li>
    </ul>
</div>

<!-- Content with a width which would require scrolling -->
<div id="scrollable" style="" class="yui3-scrollview-loading horiz">
    <ul>
        <li><img src="..."></li>
        <li><img src="..."></li>
        <li><img src="..."></li>
        <li><img src="..."></li>
    </ul>
</div>

But this time, when we instantiate the ScrollView instance, we provide a fixed width, as opposed to a fixed height, for the widget.

Also, since we have images which act as drag/flick targets, we need to stop the default image drag/drop behavior for gecko, by preventing default on the underlying mousedown event used by flick:

// Constraining the width, instead of the height for horizontal scrolling
var scrollView = new Y.ScrollView({
    srcNode: '#scrollable',
    width: 320,
 
    flick : {
        preventDefault:function(e) {
            // Prevent image drag in gecko (assuming non-touch for this example).
            return (Y.UA.gecko);
        },
        minDistance:10,
        minVelocity:0.3
    }
 
});
 
scrollView.render();

// Constraining the width, instead of the height for horizontal scrolling
var scrollView = new Y.ScrollView({
    srcNode: '#scrollable',
    width: 320,
 
    flick : {
        preventDefault:function(e) {
            // Prevent image drag in gecko (assuming non-touch for this example).
            return (Y.UA.gecko);
        },
        minDistance:10,
        minVelocity:0.3
    }
 
});
 
scrollView.render();

This causes the list content (which has inline-block applied to each LI by the scrollview CSS) to be wider than the ScrollView, forcing horizontal scrolling. The height of the ScrollView in this case is driven by the height of it's content.