|
1
|
1 |
|
|
|
2 |
//** Created: March 19th, 08' |
|
|
3 |
//** Aug 16th, 08'- Updated to v 1.4: |
|
|
4 |
//1) Adds ability to set speed/duration of panel animation (in milliseconds) |
|
|
5 |
//2) Adds persistence support, so the last viewed panel is recalled when viewer returns within same browser session |
|
|
6 |
//3) Adds ability to specify whether panels should stop at the very last and first panel, or wrap around and start all over again |
|
|
7 |
//4) Adds option to specify two navigational image links positioned to the left and right of the Carousel Viewer to move the panels back and forth |
|
|
8 |
|
|
|
9 |
//** Aug 27th, 08'- Nav buttons (if enabled) also repositions themselves now if window is resized |
|
|
10 |
|
|
|
11 |
var stepcarousel={ |
|
|
12 |
ajaxloadingmsg: '<div style="margin: 1em; font-weight: bold"><img src="ajaxloadr.gif" style="vertical-align: middle" /> Fetching Content. Please wait...</div>', //customize HTML to show while fetching Ajax content |
|
|
13 |
defaultbuttonsfade: 0.4, //Fade degree for disabled nav buttons (0=completely transparent, 1=completely opaque) |
|
|
14 |
configholder: {}, |
|
|
15 |
|
|
|
16 |
getCSSValue:function(val){ //Returns either 0 (if val contains 'auto') or val as an integer |
|
|
17 |
return (val=="auto")? 0 : parseInt(val) |
|
|
18 |
}, |
|
|
19 |
|
|
|
20 |
getremotepanels:function($, config){ //function to fetch external page containing the panel DIVs |
|
|
21 |
config.$belt.html(this.ajaxloadingmsg) |
|
|
22 |
$.ajax({ |
|
|
23 |
url: config.contenttype[1], //path to external content |
|
|
24 |
async: true, |
|
|
25 |
error:function(ajaxrequest){ |
|
|
26 |
config.$belt.html('Error fetching content.<br />Server Response: '+ajaxrequest.responseText) |
|
|
27 |
}, |
|
|
28 |
success:function(content){ |
|
|
29 |
config.$belt.html(content) |
|
|
30 |
config.$panels=config.$gallery.find('.'+config.panelclass) |
|
|
31 |
stepcarousel.alignpanels($, config) |
|
|
32 |
} |
|
|
33 |
}) |
|
|
34 |
}, |
|
|
35 |
|
|
|
36 |
getoffset:function(what, offsettype){ |
|
|
37 |
return (what.offsetParent)? what[offsettype]+this.getoffset(what.offsetParent, offsettype) : what[offsettype] |
|
|
38 |
}, |
|
|
39 |
|
|
|
40 |
getCookie:function(Name){ |
|
|
41 |
var re=new RegExp(Name+"=[^;]+", "i"); //construct RE to search for target name/value pair |
|
|
42 |
if (document.cookie.match(re)) //if cookie found |
|
|
43 |
return document.cookie.match(re)[0].split("=")[1] //return its value |
|
|
44 |
return null |
|
|
45 |
}, |
|
|
46 |
|
|
|
47 |
setCookie:function(name, value){ |
|
|
48 |
document.cookie = name+"="+value |
|
|
49 |
}, |
|
|
50 |
|
|
|
51 |
fadebuttons:function(config, currentpanel){ |
|
|
52 |
config.$leftnavbutton.fadeTo('fast', currentpanel==0? this.defaultbuttonsfade : 1) |
|
|
53 |
config.$rightnavbutton.fadeTo('fast', currentpanel==config.lastvisiblepanel? this.defaultbuttonsfade : 1) |
|
|
54 |
}, |
|
|
55 |
|
|
|
56 |
addnavbuttons:function(config, currentpanel){ |
|
|
57 |
config.$leftnavbutton=$('<img src="'+config.defaultbuttons.leftnav[0]+'">').css({zIndex:50, position:'absolute', left:config.offsets.left+config.defaultbuttons.leftnav[1]+'px', top:config.offsets.top+config.defaultbuttons.leftnav[2]+'px', cursor:'hand', cursor:'pointer'}).attr({title:'Back '+config.defaultbuttons.moveby+' panels'}).appendTo('body') |
|
|
58 |
config.$rightnavbutton=$('<img src="'+config.defaultbuttons.rightnav[0]+'">').css({zIndex:50, position:'absolute', left:config.offsets.left+config.$gallery.get(0).offsetWidth+config.defaultbuttons.rightnav[1]+'px', top:config.offsets.top+config.defaultbuttons.rightnav[2]+'px', cursor:'hand', cursor:'pointer'}).attr({title:'Forward '+config.defaultbuttons.moveby+' panels'}).appendTo('body') |
|
|
59 |
config.$leftnavbutton.bind('click', function(){ //assign nav button event handlers |
|
|
60 |
stepcarousel.stepBy(config.galleryid, -config.defaultbuttons.moveby) |
|
|
61 |
}) |
|
|
62 |
config.$rightnavbutton.bind('click', function(){ //assign nav button event handlers |
|
|
63 |
stepcarousel.stepBy(config.galleryid, config.defaultbuttons.moveby) |
|
|
64 |
}) |
|
|
65 |
if (config.panelbehavior.wraparound==false){ //if carousel viewer should stop at first or last panel (instead of wrap back or forth) |
|
|
66 |
this.fadebuttons(config, currentpanel) |
|
|
67 |
} |
|
|
68 |
}, |
|
|
69 |
|
|
|
70 |
alignpanels:function($, config){ |
|
|
71 |
var paneloffset=0 |
|
|
72 |
config.paneloffsets=[paneloffset] //array to store upper left offset of each panel (1st element=0) |
|
|
73 |
config.panelwidths=[] //array to store widths of each panel |
|
|
74 |
config.$panels.each(function(index){ //loop through panels |
|
|
75 |
var $currentpanel=$(this) |
|
|
76 |
$currentpanel.css({float: 'none', position: 'absolute', left: paneloffset+'px'}) //position panel |
|
|
77 |
$currentpanel.bind('click', function(e){return config.onpanelclick(e.target)}) //bind onpanelclick() to onclick event |
|
|
78 |
paneloffset+=stepcarousel.getCSSValue($currentpanel.css('marginRight')) + parseInt($currentpanel.get(0).offsetWidth || $currentpanel.css('width')) //calculate next panel offset |
|
|
79 |
config.paneloffsets.push(paneloffset) //remember this offset |
|
|
80 |
config.panelwidths.push(paneloffset-config.paneloffsets[config.paneloffsets.length-2]) //remember panel width |
|
|
81 |
}) |
|
|
82 |
config.paneloffsets.pop() //delete last offset (redundant) |
|
|
83 |
var addpanelwidths=0 |
|
|
84 |
var lastpanelindex=config.$panels.length-1 |
|
|
85 |
config.lastvisiblepanel=lastpanelindex |
|
|
86 |
for (var i=config.$panels.length-1; i>=0; i--){ |
|
|
87 |
addpanelwidths+=(i==lastpanelindex? config.panelwidths[lastpanelindex] : config.paneloffsets[i+1]-config.paneloffsets[i]) |
|
|
88 |
if (config.gallerywidth>addpanelwidths){ |
|
|
89 |
config.lastvisiblepanel=i //calculate index of panel that when in 1st position reveals the very last panel all at once based on gallery width |
|
|
90 |
} |
|
|
91 |
} |
|
|
92 |
config.$belt.css({width: paneloffset+'px'}) //Set Belt DIV to total panels' widths |
|
|
93 |
config.currentpanel=(config.panelbehavior.persist)? parseInt(this.getCookie(window[config.galleryid+"persist"])) : 0 //determine 1st panel to show by default |
|
|
94 |
config.currentpanel=(typeof config.currentpanel=="number" && config.currentpanel<config.$panels.length)? config.currentpanel : 0 |
|
|
95 |
if (config.currentpanel!=0){ |
|
|
96 |
var endpoint=config.paneloffsets[config.currentpanel]+(config.currentpanel==0? 0 : config.beltoffset) |
|
|
97 |
config.$belt.css({left: -endpoint+'px'}) |
|
|
98 |
} |
|
|
99 |
if (config.defaultbuttons.enable==true){ //if enable default back/forth nav buttons |
|
|
100 |
this.addnavbuttons(config, config.currentpanel) |
|
|
101 |
$(window).bind("load, resize", function(){ //refresh position of nav buttons when page loads/resizes, in case offsets weren't available document.oncontentload |
|
|
102 |
config.offsets={left:stepcarousel.getoffset(config.$gallery.get(0), "offsetLeft"), top:stepcarousel.getoffset(config.$gallery.get(0), "offsetTop")} |
|
|
103 |
config.$leftnavbutton.css({left:config.offsets.left+config.defaultbuttons.leftnav[1]+'px', top:config.offsets.top+config.defaultbuttons.leftnav[2]+'px'}) |
|
|
104 |
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'}) |
|
|
105 |
}) |
|
|
106 |
} |
|
|
107 |
this.statusreport(config.galleryid) |
|
|
108 |
config.oninit() |
|
|
109 |
config.onslideaction(this) |
|
|
110 |
}, |
|
|
111 |
|
|
|
112 |
stepTo:function(galleryid, pindex){ /*User entered pindex starts at 1 for intuitiveness. Internally pindex still starts at 0 */ |
|
|
113 |
var config=stepcarousel.configholder[galleryid] |
|
|
114 |
if (typeof config=="undefined"){ |
|
|
115 |
alert("There's an error with your set up of Carousel Viewer \""+galleryid+ "\"!") |
|
|
116 |
return |
|
|
117 |
} |
|
|
118 |
var pindex=Math.min(pindex-1, config.paneloffsets.length-1) |
|
|
119 |
var endpoint=config.paneloffsets[pindex]+(pindex==0? 0 : config.beltoffset) |
|
|
120 |
if (config.panelbehavior.wraparound==false && config.defaultbuttons.enable==true){ //if carousel viewer should stop at first or last panel (instead of wrap back or forth) |
|
|
121 |
this.fadebuttons(config, pindex) |
|
|
122 |
} |
|
|
123 |
config.$belt.animate({left: -endpoint+'px'}, config.panelbehavior.speed, function(){config.onslideaction(this)}) |
|
|
124 |
config.currentpanel=pindex |
|
|
125 |
this.statusreport(galleryid) |
|
|
126 |
}, |
|
|
127 |
|
|
|
128 |
stepBy:function(galleryid, steps){ |
|
|
129 |
var config=stepcarousel.configholder[galleryid] |
|
|
130 |
if (typeof config=="undefined"){ |
|
|
131 |
alert("There's an error with your set up of Carousel Viewer \""+galleryid+ "\"!") |
|
|
132 |
return |
|
|
133 |
} |
|
|
134 |
var direction=(steps>0)? 'forward' : 'back' //If "steps" is negative, that means backwards |
|
|
135 |
var pindex=config.currentpanel+steps //index of panel to stop at |
|
|
136 |
if (config.panelbehavior.wraparound==false){ //if carousel viewer should stop at first or last panel (instead of wrap back or forth) |
|
|
137 |
pindex=(direction=="back" && pindex<=0)? 0 : (direction=="forward")? Math.min(pindex, config.lastvisiblepanel) : pindex |
|
|
138 |
if (config.defaultbuttons.enable==true){ //if default nav buttons are enabled, fade them in and out depending on if at start or end of carousel |
|
|
139 |
stepcarousel.fadebuttons(config, pindex) |
|
|
140 |
} |
|
|
141 |
} |
|
|
142 |
else{ //else, for normal stepBy behavior |
|
|
143 |
pindex=(pindex>config.paneloffsets.length-1 || pindex<0 && pindex-steps>0)? 0 : (pindex<0)? config.paneloffsets.length+steps : pindex //take into account end or starting panel and step direction |
|
|
144 |
} |
|
|
145 |
var endpoint=config.paneloffsets[pindex]+(pindex==0? 0 : config.beltoffset) //left distance for Belt DIV to travel to |
|
|
146 |
if (pindex==0 && direction=='forward' || config.currentpanel==0 && direction=='back' && config.panelbehavior.wraparound==true){ //decide whether to apply "push pull" effect |
|
|
147 |
config.$belt.animate({left: -config.paneloffsets[config.currentpanel]-(direction=='forward'? 100 : -30)+'px'}, 'normal', function(){ |
|
|
148 |
config.$belt.animate({left: -endpoint+'px'}, config.panelbehavior.speed, function(){config.onslideaction(this)}) |
|
|
149 |
}) |
|
|
150 |
} |
|
|
151 |
else |
|
|
152 |
config.$belt.animate({left: -endpoint+'px'}, config.panelbehavior.speed, function(){config.onslideaction(this)}) |
|
|
153 |
config.currentpanel=pindex |
|
|
154 |
this.statusreport(galleryid) |
|
|
155 |
}, |
|
|
156 |
|
|
|
157 |
statusreport:function(galleryid){ |
|
|
158 |
var config=stepcarousel.configholder[galleryid] |
|
|
159 |
var startpoint=config.currentpanel //index of first visible panel |
|
|
160 |
var visiblewidth=0 |
|
|
161 |
for (var endpoint=startpoint; endpoint<config.paneloffsets.length; endpoint++){ //index (endpoint) of last visible panel |
|
|
162 |
visiblewidth+=config.panelwidths[endpoint] |
|
|
163 |
if (visiblewidth>config.gallerywidth){ |
|
|
164 |
break |
|
|
165 |
} |
|
|
166 |
} |
|
|
167 |
startpoint+=1 //format startpoint for user friendiness |
|
|
168 |
endpoint=(endpoint+1==startpoint)? startpoint : endpoint //If only one image visible on the screen and partially hidden, set endpoint to startpoint |
|
|
169 |
var valuearray=[startpoint, endpoint, config.panelwidths.length] |
|
|
170 |
for (var i=0; i<config.statusvars.length; i++){ |
|
|
171 |
window[config.statusvars[i]]=valuearray[i] //Define variable (with user specified name) and set to one of the status values |
|
|
172 |
config.$statusobjs[i].text(valuearray[i]+" ") //Populate element on page with ID="user specified name" with one of the status values |
|
|
173 |
} |
|
|
174 |
}, |
|
|
175 |
|
|
|
176 |
setup:function(config){ |
|
|
177 |
//Disable Step Gallery scrollbars ASAP dynamically (enabled for sake of users with JS disabled) |
|
|
178 |
document.write('<style type="text/css">\n#'+config.galleryid+'{overflow: hidden;}\n</style>') |
|
|
179 |
jQuery(document).ready(function($){ |
|
|
180 |
config.$gallery=$('#'+config.galleryid) |
|
|
181 |
config.gallerywidth=config.$gallery.width() |
|
|
182 |
config.offsets={left:stepcarousel.getoffset(config.$gallery.get(0), "offsetLeft"), top:stepcarousel.getoffset(config.$gallery.get(0), "offsetTop")} |
|
|
183 |
config.$belt=config.$gallery.find('.'+config.beltclass) //Find Belt DIV that contains all the panels |
|
|
184 |
config.$panels=config.$gallery.find('.'+config.panelclass) //Find Panel DIVs that each contain a slide |
|
|
185 |
config.onpanelclick=(typeof config.onpanelclick=="undefined")? function(target){} : config.onpanelclick //attach custom "onpanelclick" event handler |
|
|
186 |
config.onslideaction=(typeof config.onslide=="undefined")? function(){} : function(beltobj){$(beltobj).stop(); config.onslide()} //attach custom "onslide" event handler |
|
|
187 |
config.oninit=(typeof config.oninit=="undefined")? function(){} : config.oninit //attach custom "oninit" event handler |
|
|
188 |
config.beltoffset=stepcarousel.getCSSValue(config.$belt.css('marginLeft')) //Find length of Belt DIV's left margin |
|
|
189 |
config.statusvars=config.statusvars || [] //get variable names that will hold "start", "end", and "total" slides info |
|
|
190 |
config.$statusobjs=[$('#'+config.statusvars[0]), $('#'+config.statusvars[1]), $('#'+config.statusvars[2])] |
|
|
191 |
config.currentpanel=0 |
|
|
192 |
stepcarousel.configholder[config.galleryid]=config //store config parameter as a variable |
|
|
193 |
if (config.contenttype[0]=="ajax" && typeof config.contenttype[1]!="undefined") //fetch ajax content? |
|
|
194 |
stepcarousel.getremotepanels($, config) |
|
|
195 |
else |
|
|
196 |
stepcarousel.alignpanels($, config) //align panels and initialize gallery |
|
|
197 |
}) //end document.ready |
|
|
198 |
jQuery(window).bind('unload', function(){ //clean up |
|
|
199 |
if (config.panelbehavior.persist){ |
|
|
200 |
stepcarousel.setCookie(window[config.galleryid+"persist"], config.currentpanel) |
|
|
201 |
} |
|
|
202 |
jQuery.each(config, function(ai, oi){ |
|
|
203 |
oi=null |
|
|
204 |
}) |
|
|
205 |
config=null |
|
|
206 |
}) |
|
|
207 |
} |
|
|
208 |
} |
|
|
209 |
|
|
|
210 |
|