jQuery.SerialScroll 1.2.1

jQuery.SerialScroll doesnt have one definite purpose. Its generic and adaptable. You can certainly use it as a screen slider. That is, to sequentially navigate a group of screens.

This plugin can also animate a text scroller in no time. It can definitely handle slideshows, the high customizability of the scrolling effect lets you create beautiful animations. You can even build an automatic news ticker!

jQuery.SerialScroll gives you access to a lot of options. These are:

• target: The element to scroll, its relative to the matched element.
• • If you dont specify this option, the scrolled element is the one you called serialScroll on.
• event: on which event to react (click by default).
• start: first element of the series (zero-based index, 0 by default).
• step: how many elements to scroll each time. Use a negative number to go on the other way.
• lock: if true(default), the plugin will ignore events if already animating. Then animations cant be queued.
• cycle: if true, the first element will be shown after going over the last, and the other way around.
• stop: if true, the plugin will stop any previous animations of the element, to avoid queuing.
• force: if true, an initial scroll will be forced on start.
• jump: if true, the specified event can be triggered on the items, and the container will scroll to them.
• items: selector to the items(relative to the scrolled element).
• prev: (optional)selector to the previous button.
• next: (optional)selector to the next button.
• lazy: if true, the items are collected each time, allowing dynamic content(AJAX, AHAH, jQuery manipulation, etc).
• interval: If you specify a number, the plugin will add auto scrolling with that interval.
• constant: Should the speed remain constant, no matter how many items we scroll at once ? (true by default).
• navigation: Optionally, a selector to a group of elements, that allow scrolling to specific elements by index. Can be less than the amount of items.
• exclude new: If you want the plugin, to stop scrolling before the actual last element, set this to a number, and that amount of items is ignored counting from the end.

This is useful if you show many items simultaneously, in that case, you probably want to set this option to the amount of visible items 1.

onBeforeA function to be called before each scrolling. It receives the following arguments: event object, targeted element, element to be scrolled, collection of items and position of the targeted element in the collection.

The scope(this) will point to the element that got the event. If the function returns false, the event is ignored.