/**
* jCarouselLite - jQuery plugin to navigate images/any content in a carousel style widget.
* @requires jQuery v1.2 or above
*
* http://gmarwaha.com/jquery/jcarousellite/
*
* Copyright (c) 2007 Ganeshji Marwaha (gmarwaha.com)
* Dual licensed under the MIT and GPL licenses:
* http://www.opensource.org/licenses/mit-license.php
* http://www.gnu.org/licenses/gpl.html
*
* Version: 1.0.1
* Note: Requires jquery 1.2 or above from version 1.0.1
*/
/**
* Creates a carousel-style navigation widget for images/any-content from a simple HTML markup.
*
* The HTML markup that is used to build the carousel can be as simple as...
*
*
*
*
*
*
*
*
*
* As you can see, this snippet is nothing but a simple div containing an unordered list of images.
* You don't need any special "class" attribute, or a special "css" file for this plugin.
* I am using a class attribute just for the sake of explanation here.
*
* To navigate the elements of the carousel, you need some kind of navigation buttons.
* For example, you will need a "previous" button to go backward, and a "next" button to go forward.
* This need not be part of the carousel "div" itself. It can be any element in your page.
* Lets assume that the following elements in your document can be used as next, and prev buttons...
*
*
*
*
* Now, all you need to do is call the carousel component on the div element that represents it, and pass in the
* navigation buttons as options.
*
* $(".carousel").jCarouselLite({
* btnNext: ".next",
* btnPrev: ".prev"
* });
*
* That's it, you would have now converted your raw div, into a magnificient carousel.
*
* There are quite a few other options that you can use to customize it though.
* Each will be explained with an example below.
*
* @param an options object - You can specify all the options shown below as an options object param.
*
* @option btnPrev, btnNext : string - no defaults
* @example
* $(".carousel").jCarouselLite({
* btnNext: ".next",
* btnPrev: ".prev"
* });
* @desc Creates a basic carousel. Clicking "btnPrev" navigates backwards and "btnNext" navigates forward.
*
* @option btnGo - array - no defaults
* @example
* $(".carousel").jCarouselLite({
* btnNext: ".next",
* btnPrev: ".prev",
* btnGo: [".0", ".1", ".2"]
* });
* @desc If you don't want next and previous buttons for navigation, instead you prefer custom navigation based on
* the item number within the carousel, you can use this option. Just supply an array of selectors for each element
* in the carousel. The index of the array represents the index of the element. What i mean is, if the
* first element in the array is ".0", it means that when the element represented by ".0" is clicked, the carousel
* will slide to the first element and so on and so forth. This feature is very powerful. For example, i made a tabbed
* interface out of it by making my navigation elements styled like tabs in css. As the carousel is capable of holding
* any content, not just images, you can have a very simple tabbed navigation in minutes without using any other plugin.
* The best part is that, the tab will "slide" based on the provided effect. :-)
*
* @option mouseWheel : boolean - default is false
* @example
* $(".carousel").jCarouselLite({
* mouseWheel: true
* });
* @desc The carousel can also be navigated using the mouse wheel interface of a scroll mouse instead of using buttons.
* To get this feature working, you have to do 2 things. First, you have to include the mouse-wheel plugin from brandon.
* Second, you will have to set the option "mouseWheel" to true. That's it, now you will be able to navigate your carousel
* using the mouse wheel. Using buttons and mouseWheel or not mutually exclusive. You can still have buttons for navigation
* as well. They complement each other. To use both together, just supply the options required for both as shown below.
* @example
* $(".carousel").jCarouselLite({
* btnNext: ".next",
* btnPrev: ".prev",
* mouseWheel: true
* });
*
* @option auto : number - default is null, meaning autoscroll is disabled by default
* @example
* $(".carousel").jCarouselLite({
* auto: 800,
* speed: 500
* });
* @desc You can make your carousel auto-navigate itself by specfying a millisecond value in this option.
* The value you specify is the amount of time between 2 slides. The default is null, and that disables auto scrolling.
* Specify this value and magically your carousel will start auto scrolling.
*
* @option speed : number - 200 is default
* @example
* $(".carousel").jCarouselLite({
* btnNext: ".next",
* btnPrev: ".prev",
* speed: 800
* });
* @desc Specifying a speed will slow-down or speed-up the sliding speed of your carousel. Try it out with
* different speeds like 800, 600, 1500 etc. Providing 0, will remove the slide effect.
*
* @option easing : string - no easing effects by default.
* @example
* $(".carousel").jCarouselLite({
* btnNext: ".next",
* btnPrev: ".prev",
* easing: "bounceout"
* });
* @desc You can specify any easing effect. Note: You need easing plugin for that. Once specified,
* the carousel will slide based on the provided easing effect.
*
* @option vertical : boolean - default is false
* @example
* $(".carousel").jCarouselLite({
* btnNext: ".next",
* btnPrev: ".prev",
* vertical: true
* });
* @desc Determines the direction of the carousel. true, means the carousel will display vertically. The next and
* prev buttons will slide the items vertically as well. The default is false, which means that the carousel will
* display horizontally. The next and prev items will slide the items from left-right in this case.
*
* @option circular : boolean - default is true
* @example
* $(".carousel").jCarouselLite({
* btnNext: ".next",
* btnPrev: ".prev",
* circular: false
* });
* @desc Setting it to true enables circular navigation. This means, if you click "next" after you reach the last
* element, you will automatically slide to the first element and vice versa. If you set circular to false, then
* if you click on the "next" button after you reach the last element, you will stay in the last element itself
* and similarly for "previous" button and first element.
*
* @option visible : number - default is 3
* @example
* $(".carousel").jCarouselLite({
* btnNext: ".next",
* btnPrev: ".prev",
* visible: 4
* });
* @desc This specifies the number of items visible at all times within the carousel. The default is 3.
* You are even free to experiment with real numbers. Eg: "3.5" will have 3 items fully visible and the
* last item half visible. This gives you the effect of showing the user that there are more images to the right.
*
* @option start : number - default is 0
* @example
* $(".carousel").jCarouselLite({
* btnNext: ".next",
* btnPrev: ".prev",
* start: 2
* });
* @desc You can specify from which item the carousel should start. Remember, the first item in the carousel
* has a start of 0, and so on.
*
* @option scrool : number - default is 1
* @example
* $(".carousel").jCarouselLite({
* btnNext: ".next",
* btnPrev: ".prev",
* scroll: 2
* });
* @desc The number of items that should scroll/slide when you click the next/prev navigation buttons. By
* default, only one item is scrolled, but you may set it to any number. Eg: setting it to "2" will scroll
* 2 items when you click the next or previous buttons.
*
* @option beforeStart, afterEnd : function - callbacks
* @example
* $(".carousel").jCarouselLite({
* btnNext: ".next",
* btnPrev: ".prev",
* beforeStart: function(a) {
* alert("Before animation starts:" + a);
* },
* afterEnd: function(a) {
* alert("After animation ends:" + a);
* }
* });
* @desc If you wanted to do some logic in your page before the slide starts and after the slide ends, you can
* register these 2 callbacks. The functions will be passed an argument that represents an array of elements that
* are visible at the time of callback.
*
*
* @cat Plugins/Image Gallery
* @author Ganeshji Marwaha/ganeshread@gmail.com
*/
(function($) { // Compliant with jquery.noConflict()
$.fn.jCarouselLite = function(o) {
o = $.extend({
btnPrev: null,
btnNext: null,
btnGo: null,
mouseWheel: false,
auto: null,
speed: 200,
easing: null,
vertical: false,
circular: true,
visible: 3,
start: 0,
scroll: 1,
beforeStart: null,
afterEnd: null
}, o || {});
return this.each(function() { // Returns the element collection. Chainable.
var running = false, animCss=o.vertical?"top":"left", sizeCss=o.vertical?"height":"width";
var div = $(this), ul = $("ul", div), tLi = $("li", ul), tl = tLi.size(), v = o.visible;
var isMouseOver = false;
if(o.circular) {
ul.prepend(tLi.slice(tl-v-1+1).clone())
.append(tLi.slice(0,v).clone());
o.start += v;
}
var li = $("li", ul), itemLength = li.size(), curr = o.start;
div.css("visibility", "visible");
li.css({overflow: "hidden", float: o.vertical ? "none" : "left"});
ul.css({margin: "0", padding: "0", position: "relative", "list-style-type": "none", "z-index": "1"});
div.css({overflow: "hidden", position: "relative", "z-index": "2", left: "0px"});
var liSize = o.vertical ? height(li) : width(li); // Full li size(incl margin)-Used for animation
var ulSize = liSize * itemLength; // size of full ul(total length, not just for the visible items)
var divSize = liSize * v; // size of entire div(total length for just the visible items)
li.css({width: li.width(), height: li.height()});
ul.css(sizeCss, ulSize+"px").css(animCss, -(curr*liSize));
li.mouseover(function(){ isMouseOver = true; });
li.mouseout(function(){ isMouseOver = false; });
div.css(sizeCss, divSize+"px"); // Width of the DIV. length of visible images
if(o.btnPrev)
$(o.btnPrev).click(function() {
return go(curr-o.scroll);
});
if(o.btnNext)
$(o.btnNext).click(function() {
return go(curr+o.scroll);
});
if(o.btnGo)
$.each(o.btnGo, function(i, val) {
$(val).click(function() {
return go(o.circular ? o.visible+i : i);
});
});
if(o.mouseWheel && div.mousewheel)
div.mousewheel(function(e, d) {
return d>0 ? go(curr-o.scroll) : go(curr+o.scroll);
});
if(o.auto){
setInterval(function() {
if(isMouseOver) return;
go(curr+o.scroll);
}, o.auto+o.speed);
}
function vis() {
return li.slice(curr).slice(0,v);
};
function go(to) {
if(!running) {
if(o.beforeStart)
o.beforeStart.call(this, vis());
if(o.circular) { // If circular we are in first or last, then goto the other end
if(to<=o.start-v-1) { // If first, then goto last
ul.css(animCss, -((itemLength-(v*2))*liSize)+"px");
// If "scroll" > 1, then the "to" might not be equal to the condition; it can be lesser depending on the number of elements.
curr = to==o.start-v-1 ? itemLength-(v*2)-1 : itemLength-(v*2)-o.scroll;
} else if(to>=itemLength-v+1) { // If last, then goto first
ul.css(animCss, -( (v) * liSize ) + "px" );
// If "scroll" > 1, then the "to" might not be equal to the condition; it can be greater depending on the number of elements.
curr = to==itemLength-v+1 ? v+1 : v+o.scroll;
} else curr = to;
} else { // If non-circular and to points to first or last, we just return.
if(to<0 || to>itemLength-v) return;
else curr = to;
} // If neither overrides it, the curr will still be "to" and we can proceed.
running = true;
ul.animate(
animCss == "left" ? { left: -(curr*liSize) } : { top: -(curr*liSize) } , o.speed, o.easing,
function() {
if(o.afterEnd)
o.afterEnd.call(this, vis());
running = false;
}
);
// Disable buttons when the carousel reaches the last/first, and enable when not
if(!o.circular) {
$(o.btnPrev + "," + o.btnNext).removeClass("disabled");
$( (curr-o.scroll<0 && o.btnPrev)
||
(curr+o.scroll > itemLength-v && o.btnNext)
||
[]
).addClass("disabled");
}
}
return false;
};
});
};
function css(el, prop) {
return parseInt($.css(el[0], prop)) || 0;
};
function width(el) {
return el[0].offsetWidth + css(el, 'marginLeft') + css(el, 'marginRight');
};
function height(el) {
return el[0].offsetHeight + css(el, 'marginTop') + css(el, 'marginBottom');
};
})(jQuery);
/*
(function($) { // Compliant with jquery.noConflict()
$.fn.jCarouselLite = function(o) {
o = $.extend({
btnPrev: null,
btnNext: null,
btnRegExp: null,
btnNavTarget: null,
btnGo: null,
btnIndicator: "ul.nav-carousel li",
mouseWheel: false,
auto: true,
pauseOnHover: true,
disableClass: "disabled",
speed: 3000,
easing: null,
vertical: false,
circular: true,
visible: 3,
start: 0,
scroll: 1,
autoTimer: true,
rows: 1, //ADDED: Property to allow multiple rows
beforeStart: null,
afterEnd: null,
carousel: "div.content-body div.carousel",
panel: "div.cell-wrapper",
labels: false,
createNav: false,
btnNavContainer: '
'
}, o || {});
return this.each(function() { // Returns the element collection. Chainable.
var running = false, animCss = o.vertical ? "top" : "left", sizeCss = o.vertical ? "height" : "width";
var div = $(this), ol = $(o.carousel), tLi = $(o.panel, o.carousel), tl = tLi.size(), v = o.visible;
var rowCss = o.vertical ? "width" : "height"; //ADDED: rowCss is used to set the height/width of the viewport based on how many rows are showing
var isMouseOver = false;
// added: only perform if li > 1
if(o.circular && tl > 1) {
ol.prepend(tLi.slice(tl-v-1+1).clone()).append(tLi.slice(0,v).clone());
o.start += v;
}
if(o.createNav){
create_navigation();
}
update_navigation(1);
var li = $(o.panel, o.carousel), itemLength = li.size(), curr = o.start;
div.css("visibility", "visible");
if(tl > 1){
hideAndShowFlashContent(li, 1);
}
li.css({ overflow: "hidden", float: o.vertical ? "none" : "left" });
ol.css({ margin: "0", padding: "0", position: "relative", "list-style-type": "none", "z-index": "1" });
div.css({ overflow: "hidden", position: "relative", "z-index": "2", left: "0px" });
var liSize = o.vertical ? height(li) : width(li); // Full li size(incl margin)-Used for animation
var liRowSize = o.vertical ? width(li) : height(li); //ADDED: size of the li's row
var olSize = ((liSize * itemLength) / o.rows) + (liSize / 1.5); // size of full ul(total length, not just for the visible items)
var divSize = liSize * v; // size of entire div(total length for just the visible items)
var rowSize = liRowSize * o.rows; //ADDED: gets the size in pixels of the height/width of the viewport
li.css({ width: li.width(), height: li.height() });
ol.css(sizeCss, olSize + "px").css(animCss, -(curr * liSize));
// div.css(sizeCss, divSize + "px"); // Width of the DIV. length of visible images
ol.css(rowCss, rowSize + "px"); //ADDED: Height of the DIV; MODIFIED: height of ol instead of div
li.mouseover(function(){ isMouseOver = true; });
li.mouseout(function(){ isMouseOver = false; });
//ADDED: special consideration for vertical carousels with multiple rows
if (o.vertical && o.rows > 1) {
ol.children().filter(function(index) {
return ((index + 1) % o.rows > 0);
}).css({ float: "left", width: "" });
}
if(o.btnPrev){
$(o.btnPrev).mouseover(function(){ isMouseOver = true; });
$(o.btnPrev).mouseout(function(){ isMouseOver = false; });
$(o.btnPrev).livequery("click",function() {
return go(curr-o.scroll);
});
}
if(o.btnNext){
$(o.btnNext).mouseover(function(){ isMouseOver = true; });
$(o.btnNext).mouseout(function(){ isMouseOver = false; });
$(o.btnNext).livequery("click",function() {
return go(curr+o.scroll);
});
}
if(o.btnGo) {
$.each(o.btnGo, function(i, val) {
$(val).click(function() {
return go(o.circular ? o.visible+i : i+1);
});
});
}
if (o.mouseWheel && div.mousewheel) {
div.mousewheel(function(e, d) {
return d > 0 ? go(curr - o.scroll) : go(curr + o.scroll);
});
}
if(o.auto){
setInterval(function() {
if(o.pauseOnHover && isMouseOver) return;
go(curr+o.scroll);
}, o.auto+o.speed);
}
function vis() {
return li.slice(curr).slice(0, v);
};
function go(to) {
if (!running) {
if (o.beforeStart)
o.beforeStart.call(this, vis());
if (o.circular) { // If circular we are in first or last, then goto the other end
// console.debug(to,curr);
if (to <= o.start - v - 1) { // If first, then goto last
ol.css(animCss, -((itemLength - (v * 2)) * liSize) + "px");
// If "scroll" > 1, then the "to" might not be equal to the condition; it can be lesser depending on the number of elements.
curr = to == o.start - v - 1 ? itemLength - (v * 2) - 1 : itemLength - (v * 2) - o.scroll;
} else if (to >= itemLength - v + 1) { // If last, then goto first
ol.css(animCss, -((v) * liSize) + "px");
// If "scroll" > 1, then the "to" might not be equal to the condition; it can be greater depending on the number of elements.
curr = to == itemLength - v + 1 ? v + 1 : v + o.scroll;
} else curr = to;
} else {
// If non-circular and to points to first or last, we just return.
//ADDED: This determines when to stop scrolling when more than 1 row is viewable
if (to < 0 || to > ((itemLength - v) / o.rows)) return;
else curr = to;
} // If neither overrides it, the curr will still be "to" and we can proceed.
running = true;
ol.animate(
animCss == "left" ? { left: -(curr * liSize)} : { top: -(curr * liSize) }, o.speed, o.easing,
function() {
if (o.afterEnd)
o.afterEnd.call(this, vis());
running = false;
}
);
hideAndShowFlashContent(li, curr);
update_navigation((o.circular) ? 0+curr : 1+curr);
if(o.labels){
update_lables(curr);
}
// Disable buttons when the carousel reaches the last/first, and enable when not
if (!o.circular) {
$(o.btnPrev + "," + o.btnNext).removeClass("disabled");
//ADDED: This determines when to add the disabled class to the link when more than 1 row is viewable
$( (curr - o.scroll < 0 && o.btnPrev) || (curr + o.scroll > ((itemLength - v) / o.rows) && o.btnNext) || [] ).addClass(o.disableClass);
}
}
return false;
};
function hideAndShowFlashContent(liElements,curr){
$(liElements).each(function(i){
if(i != curr){
$(this).children().children("object").each(function(){
$(this).css({
visibility: "hidden",
position: "relative",
zIndex: 0
});
});
if($(this).children().children("object").size() > 0){
var videoPlayer = $(this).children().children("object");
//videoPlayer.runCommand(["Video Player 1", "togglePlay", false, 'off']);
}
} else {
$(this).children().children("object").each(function(){
$(this).css({ visibility: "visible" });
$(this).children("embed").css({
position: "relative",
zIndex: 0
});
});
}
});
}
function update_lables(curr){
var kids = $(o.carousel).children();
var nextPos = curr+1;
var prevPos = curr;
var nextREPLACE = $(kids[nextPos]).children().children("caption").html();
var prevREPLACE = $(kids[prevPos]).children().children("caption").html();
var re = new RegExp(o.btnRegExp, "g");
var btnNextHtmlNew = $(o.btnNext).parent().html().replace(re, nextREPLACE);
var btnPrevHtmlNew = $(o.btnPrev).parent().html().replace(re, prevREPLACE);
$(o.btnNext).parent().html(btnNextHtmlNew);
$(o.btnPrev).parent().html(btnPrevHtmlNew);
}
function create_navigation(){
if ($(o.carousel).size() > 0) {
// build links
$(o.carousel).each(function(i){
if($(this).children().size() > 1) {
$(this).parent().append(o.btnNavContainer);
var carouselNavDiv = $(this).parent().children(o.btnNavTarget);
$(carouselNavDiv).append(o.btnPrevHtml);
$(this).children().each(function(j){
panelNum = j;
linkNum = (j+1);
$(carouselNavDiv).append('
'+linkNum+'
');
});
$(carouselNavDiv).append(o.btnNextHtml);
}
});
}
}
// Clean up and abstract this code. @todo
function update_navigation(curr){
var kids = $(o.panel);
var cloneVal = (o.circular) ? 2 : 0;
var pos = (kids.size()-cloneVal <= curr) ? (curr > kids.size()-cloneVal) ? 2 : kids.size()-cloneVal : curr;
pos = (pos == 0) ? kids.size()-cloneVal : pos;
var indicatorImages = $(o.btnIndicator);
var sectionLinks = $("#sectionlinks a");
for(k = 0; k < indicatorImages.size(); k++){
if(pos == k+1){
$(indicatorImages[k]).attr("class", 'on');
} else {
$(indicatorImages[k]).attr("class", 'off');
}
}
for(k = 0; k < sectionLinks.size(); k++){
if(pos == k+1){
$(sectionLinks[k]).attr("class", 'selected');
} else {
$(sectionLinks[k]).attr("class", 'off');
}
}
};
});
};
function css(el, prop) {
return parseInt($.css(el[0], prop)) || 0;
};
function width(el) {
return el[0].offsetWidth + css(el, 'marginLeft') + css(el, 'marginRight');
};
function height(el) {
return el[0].offsetHeight + css(el, 'marginTop') + css(el, 'marginBottom');
};
})(jQuery);
*/
* 
* 
*