simplyScroll v2

a flexible jQuery content scroller with touch support

Jump to: [Features] [Examples] [Download] [Configuration] [Comments]

simplyScroll is a scroll-tastic jQuery plugin that can animate (scroll) content either automatically or manually, horizontally or vertically, backwards or forwards.

New Features in v2

Features

Examples

  1. Horizontal scroll with loop (infinite effect)
  2. As above but manual scroll with buttons
  3. Manual Vertical scroll, with buttons, looped
  4. Custom HTML example, scrolling backwards
  5. RTL mode page may look odd (or better)!
  6. Pause and resume

Download

simplyScroll is open source and dual licensed under MIT and GPL licenses. Latest version simplyScroll 2.0.5 released 10/05/12

jquery.simplyscroll.zip30 KbRecommended Complete package including CSS & buttons.png
jquery.simplyscroll.js13 KbSource
jquery.simplyscroll.min.js8 Kbminified (uncompressed)

Configuration

simplyScroll can be configured with a number of options

PropertyDefaultDescription
customClass'simply-scroll'Class name for styling
frameRate24Number of movements/frames per second
speed1Number of pixels moved per frame, in 'loop' mode must be divisible by total width of scroller
orientation'horizontal''horizontal or 'vertical' - not to be confused with device orientation
direction'forwards''forwards' or 'backwards'
autotrueAutomatic scrolling, use false for button controls
autoMode'loop'auto = true, 'loop' or 'bounce', (disables buttons)
manualMode'end'auto = false, 'loop' or 'end' (end-to-end)
pauseOnHovertruePause scroll on hover (auto only)
pauseOnTouchtrueTouch enabled devices only (auto only)
pauseButtonfalseCreates a pause button (auto only)
startOnLoadfalseInit plugin on window.load (to allow for image loading etc)

Comments / Feedback

Notes/issues:

simplyScroll jumping? Make sure you specify images sizes or start on window load (Chrome is especially affected by this - it's just so darn fast!)

You can't use auto scrolling with buttons (yet - speed-up is a planned feature)

There's a bug in Chrome 17 (released Feb 12) that returns a false positive on a touch support test (causing hover events not to be setup), version 2.0.3 fixes this.

Any feedback or bugs should be directed to @logicbox or will@logicbox.net. Enjoy!

Images used on this page are courtesy of Key-2 Luxury / Firehouse