//Step Carousel Viewer: By Dynamic Drive, at http://www.dynamicdrive.

com
//** Created: March 19th, 08'
//** Aug 16th, 08'- Updated to v 1.4:
//1) Adds ability to set speed/duration of panel animation (in milliseco
nds)
//2) Adds persistence support, so the last viewed panel is recalled when
viewer returns within same browser session
//3) Adds ability to specify whether panels should stop at the very last
and first panel, or wrap around and start all over again
//4) Adds option to specify two navigational image links positioned to t
he left and right of the Carousel Viewer to move the panels back and forth
//** Aug 27th, 08'- Nav buttons (if enabled) also repositions themselves now if
window is resized
//** Sept 23rd, 08'- Updated to v 1.6:
//1) Carousel now stops at the very last visible panel, instead of the l
ast panel itself. In other words, no more white space at the end.
//2) Adds ability for Carousel to auto rotate dictated by the new parame
ter: autostep: {enable:true, moveby:1, pause:3000}
//2i) During Auto Rotate, Carousel pauses onMouseover, resumes onMouseou
t. Clicking Carousel halts auto rotate.
//** Oct 22nd, 08'- Updated to v 1.6.1, which fixes functions stepBy() and stepT
o() not stopping auto stepping of Carousel when called.
var stepcarousel={
ajaxloadingmsg: '<div style="margin: 1em; font-weight: bold"><img src="a
jaxloadr.gif" style="vertical-align: middle" /> Fetching Content. Please wait...
</div>', //customize HTML to show while fetching Ajax content
defaultbuttonsfade: 0.4, //Fade degree for disabled nav buttons (0=compl
etely transparent, 1=completely opaque)
configholder: {},
getCSSValue:function(val){ //Returns either 0 (if val contains 'auto') o
r val as an integer
return (val=="auto")? 0 : parseInt(val)
},
getremotepanels:function($, config){ //function to fetch external page c
ontaining the panel DIVs
config.$belt.html(this.ajaxloadingmsg)
$.ajax({
url: config.contenttype[1], //path to external content
async: true,
error:function(ajaxrequest){
config.$belt.html('Error fetching content.<br />
Server Response: '+ajaxrequest.responseText)
},
success:function(content){
config.$belt.html(content)
config.$panels=config.$gallery.find('.'+config.p
anelclass)
stepcarousel.alignpanels($, config)
}
})
},
getoffset:function(what, offsettype){
return (what.offsetParent)? what[offsettype]+this.getoffset(what
.offsetParent, offsettype) : what[offsettype]
},
getCookie:function(Name){
var re=new RegExp(Name+"=[^;]+", "i"); //construct RE to search
for target name/value pair
if (document.cookie.match(re)) //if cookie found
return document.cookie.match(re)[0].split("=")[1] //retu
rn its value
return null
},
setCookie:function(name, value){
document.cookie = name+"="+value
},
fadebuttons:function(config, currentpanel){
config.$leftnavbutton.fadeTo('fast', currentpanel==0? this.defau
ltbuttonsfade : 1)
config.$rightnavbutton.fadeTo('fast', currentpanel==config.lastv
isiblepanel? this.defaultbuttonsfade : 1)
},
addnavbuttons:function(config, currentpanel){
config.$leftnavbutton=$('<img src="'+config.defaultbuttons.leftn
av[0]+'">').css({zIndex:50, position:'absolute', left:config.offsets.left+config
.defaultbuttons.leftnav[1]+'px', top:config.offsets.top+config.defaultbuttons.le
ftnav[2]+'px', cursor:'hand', cursor:'pointer'}).attr({title:'Previous project '
}).appendTo('body')
config.$rightnavbutton=$('<img src="'+config.defaultbuttons.righ
tnav[0]+'">').css({zIndex:50, position:'absolute', left:config.offsets.left+conf
ig.$gallery.get(0).offsetWidth+config.defaultbuttons.rightnav[1]+'px', top:confi
g.offsets.top+config.defaultbuttons.rightnav[2]+'px', cursor:'hand', cursor:'poi
nter'}).attr({title:'Next project'}).appendTo('body')
config.$leftnavbutton.bind('click', function(){ //assign nav but
ton event handlers
stepcarousel.stepBy(config.galleryid, -config.defaultbut
tons.moveby)
})
config.$rightnavbutton.bind('click', function(){ //assign nav bu
tton event handlers
stepcarousel.stepBy(config.galleryid, config.defaultbutt
ons.moveby)
})
if (config.panelbehavior.wraparound==false){ //if carousel viewe
r should stop at first or last panel (instead of wrap back or forth)
this.fadebuttons(config, currentpanel)
}
return config.$leftnavbutton.add(config.$rightnavbutton)
},
stopautostep:function(config){
clearTimeout(config.steptimer)
clearTimeout(config.resumeautostep)
},
alignpanels:function($, config){
var paneloffset=0
config.paneloffsets=[paneloffset] //array to store upper left of
fset of each panel (1st element=0)
 config.panelwidths=[] //array to store widths of each panel
config.$panels.each(function(index){ //loop through panels
var $currentpanel=$(this)
$currentpanel.css({float: 'none', position: 'absolute',
left: paneloffset+'px'}) //position panel
$currentpanel.bind('click', function(e){return config.on
panelclick(e.target)}) //bind onpanelclick() to onclick event
paneloffset+=stepcarousel.getCSSValue($currentpanel.css(
'marginRight')) + parseInt($currentpanel.get(0).offsetWidth || $currentpanel.css
('width')) //calculate next panel offset
config.paneloffsets.push(paneloffset) //remember this of
fset
config.panelwidths.push(paneloffset-config.paneloffsets[
config.paneloffsets.length-2]) //remember panel width
})
config.paneloffsets.pop() //delete last offset (redundant)
var addpanelwidths=0
var lastpanelindex=config.$panels.length-1
config.lastvisiblepanel=lastpanelindex
for (var i=config.$panels.length-1; i>=0; i--){
addpanelwidths+=(i==lastpanelindex? config.panelwidths[l
astpanelindex] : config.paneloffsets[i+1]-config.paneloffsets[i])
if (config.gallerywidth>addpanelwidths){
config.lastvisiblepanel=i //calculate index of p
anel that when in 1st position reveals the very last panel all at once based on
gallery width
}
}
config.$belt.css({width: paneloffset+'px'}) //Set Belt DIV to to
tal panels' widths
config.currentpanel=(config.panelbehavior.persist)? parseInt(thi
s.getCookie(window[config.galleryid+"persist"])) : 0 //determine 1st panel to sh
ow by default
config.currentpanel=(typeof config.currentpanel=="number" && con
fig.currentpanel<config.$panels.length)? config.currentpanel : 0
if (config.currentpanel!=0){
var endpoint=config.paneloffsets[config.currentpanel]+(c
onfig.currentpanel==0? 0 : config.beltoffset)
config.$belt.css({left: -endpoint+'px'})
}
if (config.defaultbuttons.enable==true){ //if enable default bac
k/forth nav buttons
var $navbuttons=this.addnavbuttons(config, config.curren
tpanel)
$(window).bind("load resize", function(){ //refresh posi
tion of nav buttons when page loads/resizes, in case offsets weren't available d
ocument.oncontentload
config.offsets={left:stepcarousel.getoffset(conf
ig.$gallery.get(0), "offsetLeft"), top:stepcarousel.getoffset(config.$gallery.ge
t(0), "offsetTop")}
config.$leftnavbutton.css({left:config.offsets.l
eft+config.defaultbuttons.leftnav[1]+'px', top:config.offsets.top+config.default
buttons.leftnav[2]+'px'})
config.$rightnavbutton.css({left:config.offsets.
left+config.$gallery.get(0).offsetWidth+config.defaultbuttons.rightnav[1]+'px',
top:config.offsets.top+config.defaultbuttons.rightnav[2]+'px'})
})
}
if (config.autostep && config.autostep.enable){ //enable auto st
epping of Carousel?
 var $carouselparts=config.$gallery.add(typeof $navbutton
s!="undefined"? $navbuttons : null)
$carouselparts.bind('click', function(){
stepcarousel.stopautostep(config)
config.autostep.status="stopped"
})
$carouselparts.hover(function(){ //onMouseover
stepcarousel.stopautostep(config)
config.autostep.hoverstate="over"
}, function(){ //onMouseout
if (config.steptimer && config.autostep.hoversta
te=="over" && config.autostep.status!="stopped"){
config.resumeautostep=setTimeout(functio
n(){
stepcarousel.autorotate(config.g
alleryid)
config.autostep.hoverstate="out"
}, 1500)
}
})
config.steptimer=setTimeout(function(){stepcarousel.auto
rotate(config.galleryid)}, config.autostep.pause) //automatically rotate Carouse
l Viewer
} //end enable auto stepping check
this.statusreport(config.galleryid)
config.oninit()
config.onslideaction(this)
},
stepTo:function(galleryid, pindex){ /*User entered pindex starts at 1 fo
r intuitiveness. Internally pindex still starts at 0 */
var config=stepcarousel.configholder[galleryid]
if (typeof config=="undefined"){
alert("There's an error with your set up of Carousel Vie
wer \""+galleryid+ "\"!")
return
}
stepcarousel.stopautostep(config)
var pindex=Math.min(pindex-1, config.paneloffsets.length-1)
var endpoint=config.paneloffsets[pindex]+(pindex==0? 0 : config.
beltoffset)
if (config.panelbehavior.wraparound==false && config.defaultbutt
ons.enable==true){ //if carousel viewer should stop at first or last panel (inst
ead of wrap back or forth)
this.fadebuttons(config, pindex)
}
config.$belt.animate({left: -endpoint+'px'}, config.panelbehavio
r.speed, function(){config.onslideaction(this)})
config.currentpanel=pindex
this.statusreport(galleryid)
},
stepBy:function(galleryid, steps){ //isauto if defined indicates stepBy(
) is being called automatically
var config=stepcarousel.configholder[galleryid]
if (typeof config=="undefined"){
alert("There's an error with your set up of Carousel Vie
wer \""+galleryid+ "\"!")
return
}
 stepcarousel.stopautostep(config)
var direction=(steps>0)? 'forward' : 'back' //If "steps" is nega
tive, that means backwards
var pindex=config.currentpanel+steps //index of panel to stop at
if (config.panelbehavior.wraparound==false){ //if carousel viewe
r should stop at first or last panel (instead of wrap back or forth)
pindex=(direction=="back" && pindex<=0)? 0 : (direction=
="forward")? Math.min(pindex, config.lastvisiblepanel) : pindex
if (config.defaultbuttons.enable==true){ //if default na
v buttons are enabled, fade them in and out depending on if at start or end of c
arousel
stepcarousel.fadebuttons(config, pindex)
}
}
else{ //else, for normal stepBy behavior
if (pindex>config.lastvisiblepanel && direction=="forwar
d"){
//if destination pindex is greater than last vis
ible panel, yet we're currently not at the end of the carousel yet
pindex=(config.currentpanel<config.lastvisiblepa
nel)? config.lastvisiblepanel : 0
}
else if (pindex<0 && direction=="back"){
//if destination pindex is less than 0, yet we'r
e currently not at the beginning of the carousel yet
pindex=(config.currentpanel>0)? 0 : config.lastv
isiblepanel /*wrap around left*/
}
}
var endpoint=config.paneloffsets[pindex]+(pindex==0? 0 : config.
beltoffset) //left distance for Belt DIV to travel to
if (pindex==0 && direction=='forward' || config.currentpanel==0
&& direction=='back' && config.panelbehavior.wraparound==true){ //decide whether
to apply "push pull" effect
config.$belt.animate({left: -config.paneloffsets[config.
currentpanel]-(direction=='forward'? 100 : -30)+'px'}, 'normal', function(){
config.$belt.animate({left: -endpoint+'px'}, con
fig.panelbehavior.speed, function(){config.onslideaction(this)})
})
}
else
config.$belt.animate({left: -endpoint+'px'}, config.pane
lbehavior.speed, function(){config.onslideaction(this)})
config.currentpanel=pindex
this.statusreport(galleryid)
},
autorotate:function(galleryid){
var config=stepcarousel.configholder[galleryid]
if (config.$gallery.attr('_ismouseover')!="yes"){
this.stepBy(galleryid, config.autostep.moveby)
}
config.steptimer=setTimeout(function(){stepcarousel.autorotate(g
alleryid)}, config.autostep.pause)
},
statusreport:function(galleryid){
var config=stepcarousel.configholder[galleryid]
var startpoint=config.currentpanel //index of first visible pane
l
 var visiblewidth=0
for (var endpoint=startpoint; endpoint<config.paneloffsets.lengt
h; endpoint++){ //index (endpoint) of last visible panel
visiblewidth+=config.panelwidths[endpoint]
if (visiblewidth>config.gallerywidth){
break
}
}
startpoint+=1 //format startpoint for user friendiness
endpoint=(endpoint+1==startpoint)? startpoint : endpoint //If on
ly one image visible on the screen and partially hidden, set endpoint to startpo
int
var valuearray=[startpoint, endpoint, config.panelwidths.length]
for (var i=0; i<config.statusvars.length; i++){
window[config.statusvars[i]]=valuearray[i] //Define vari
able (with user specified name) and set to one of the status values
config.$statusobjs[i].text(valuearray[i]+" ") //Populate
element on page with ID="user specified name" with one of the status values
}
},
setup:function(config){
//Disable Step Gallery scrollbars ASAP dynamically (enabled for
sake of users with JS disabled)
document.write('<style type="text/css">\n#'+config.galleryid+'{o
verflow: hidden;}\n</style>')
jQuery(document).ready(function($){
config.$gallery=$('#'+config.galleryid)
config.gallerywidth=config.$gallery.width()
config.offsets={left:stepcarousel.getoffset(config.$gall
ery.get(0), "offsetLeft"), top:stepcarousel.getoffset(config.$gallery.get(0), "o
ffsetTop")}
config.$belt=config.$gallery.find('.'+config.beltclass)
//Find Belt DIV that contains all the panels
config.$panels=config.$gallery.find('.'+config.panelclas
s) //Find Panel DIVs that each contain a slide
config.panelbehavior.wraparound=(config.autostep && conf
ig.autostep.enable)? true : config.panelbehavior.wraparound //if auto step enabl
ed, set "wraparound" to true
config.onpanelclick=(typeof config.onpanelclick=="undefi
ned")? function(target){} : config.onpanelclick //attach custom "onpanelclick" e
vent handler
config.onslideaction=(typeof config.onslide=="undefined"
)? function(){} : function(beltobj){$(beltobj).stop(); config.onslide()} //attac
h custom "onslide" event handler
config.oninit=(typeof config.oninit=="undefined")? funct
ion(){} : config.oninit //attach custom "oninit" event handler
config.beltoffset=stepcarousel.getCSSValue(config.$belt.
css('marginLeft')) //Find length of Belt DIV's left margin
config.statusvars=config.statusvars || [] //get variabl
e names that will hold "start", "end", and "total" slides info
config.$statusobjs=[$('#'+config.statusvars[0]), $('#'+c
onfig.statusvars[1]), $('#'+config.statusvars[2])]
config.currentpanel=0
stepcarousel.configholder[config.galleryid]=config //sto
re config parameter as a variable
if (config.contenttype[0]=="ajax" && typeof config.conte
nttype[1]!="undefined") //fetch ajax content?
stepcarousel.getremotepanels($, config)
else
 stepcarousel.alignpanels($, config) //align pane
ls and initialize gallery
}) //end document.ready
jQuery(window).bind('unload', function(){ //clean up
if (config.panelbehavior.persist){
stepcarousel.setCookie(window[config.galleryid+"
persist"], config.currentpanel)
}
jQuery.each(config, function(ai, oi){
oi=null
})
config=null
})
}
}