Slider - Simple Slideshow Solution
at slider.codeplex.com
Features
Supported browsers
Supported browser logos Note that roundness and shadows are not supported by some older Internet Explorer and Opera browsers. Please consider that before downloading this slideshow item.
Installation
Placing SlideShow on Your website can be made in 4 simple steps.

1. Inside <head> tag of Your HTML document, add JavaScript source code definitions for the slideshow and for the jQuery.
<script type="text/javascript" src="slideshow.min.js"></script>
<script type="text/javascript" src="jquery.min.js"></script>
2. Inside <head> tag of Your HTML document, add CSS definitions for the slideshow and for the slideshow skin You would like to use (custom skin can be generated by the configurator).
<link rel="stylesheet" type="text/css" href="slideshow.css" />
<link rel="stylesheet" type="text/css" href="slideshow-default.css" />
3. Place HTML code generated by the configurator, from the example provided with this item or HTML code created by Yourself.
<div id="my-slideshow" class="slideshow-container">
	<div class="slide">
		<img class="slide-content" src="big-buck-bunny/1.jpg" alt=""/>
		<h2 class="slide-title">Slide #1</h2>
	</div>
	<div class="slide">
		<img class="slide-content" src="big-buck-bunny/2.jpg" alt=""/>
		<h2 class="slide-title">Slide #2</h2>
	</div>
	<div class="slide">
		<img class="slide-content" src="big-buck-bunny/3.jpg" alt=""/>
		<h2 class="slide-title">Slide #3</h2>
	</div>
</div>
4. Add JavaScript code which will create Your slideshow control.
<script type="text/javascript">
	$("#my-slideshow").slideshow();
</script>
Configuration
Slideshow can be configured by adding some extra attributes to the HTML element with "slideshow-container" class or by passing an object with the configuration properties as a parameter to the slideshow constructor. Take a look at those two initialization examples, they're setting slideshow in the same state.

Configuration example #1 - by the HTML attributes

Note the "data-" prefix before every configuration attribute.
<script type="text/javascript" src="slideshow.min.js"></script>
<script type="text/javascript" src="jquery.min.js"></script>
<link rel="stylesheet" type="text/css" href="slideshow.css" />
<link rel="stylesheet" type="text/css" href="slideshow-default.css" />

<div id="my-slideshow" class="slideshow-container"
	data-skin="modern-black"
	data-autoHideNavigation="false">
	<div class="slide">
		<img class="slide-content" src="big-buck-bunny/1.jpg" alt=""/>
		<h2 class="slide-title">Slide #1</h2>
	</div>
	<div class="slide">
		<img class="slide-content" src="big-buck-bunny/2.jpg" alt=""/>
		<h2 class="slide-title">Slide #2</h2>
	</div>
	<div class="slide">
		<img class="slide-content" src="big-buck-bunny/3.jpg" alt=""/>
		<h2 class="slide-title">Slide #3</h2>
	</div>
</div>

<script type="text/javascript">
	$("#my-slideshow").slideshow();
</script>

Configuration example #2 - by the object passed as a parameter to the slideshow constructor

Note, there is no "data-" prefix here.
<script type="text/javascript" src="slideshow.min.js"></script>
<script type="text/javascript" src="jquery.min.js"></script>
<link rel="stylesheet" type="text/css" href="slideshow.css" />
<link rel="stylesheet" type="text/css" href="slideshow-default.css" />

<div id="my-slideshow" class="slideshow-container">
	<div class="slide">
		<img class="slide-content" src="big-buck-bunny/1.jpg" alt=""/>
		<h2 class="slide-title">Slide #1</h2>
	</div>
	<div class="slide">
		<img class="slide-content" src="big-buck-bunny/2.jpg" alt=""/>
		<h2 class="slide-title">Slide #2</h2>
	</div>
	<div class="slide">
		<img class="slide-content" src="big-buck-bunny/3.jpg" alt=""/>
		<h2 class="slide-title">Slide #3</h2>
	</div>
</div>

<script type="text/javascript">
	$("#my-slideshow").slideshow({
		skin : "modern-black",
		autoHideNavigation : false
	});
</script>
Configuration attributes
Name Type Default value
animationDuration
data-animationDuration
Number (integer)1000
Number of milliseconds the slide animation last.
autoHideLabel
data-autoHideLabel
Booleanfalse
Indicates whether labels are hidden when the mouse moves out from the slider area.
autoHideLinks
data-autoHideLinks
Booleantrue
Indicates whether slide links are hidden when the mouse moves out from the slider area.
autoHideNavigation
data-autoHideNavigation
Booleantrue
Indicates whether navigation buttons are hidden when the mouse moves out from the slider area.
autoStart
data-autoStart
Booleantrue
Indicates whether slideshow starts immediately after it's completely loaded.
direction
data-direction
Stringleft
Slide direction, can be one of four directions: left, right, top, bottom
navigationLocationObject(see details below)
Object that determines the navigation buttons location, it's dimensions, anchor and docking.

Object available properties are: top, left, width, height, anchor and dock.

top and left - integers, position of element in pixels
width and height - integers, dimension of element in pixels or "auto" which is the default value if width and height is not given.
anchor - determines element's anchor, that is in which slideshow corner is the 0,0 location. Can have one of these values: top-left, top-right, bottom-left, bottom-right.
dock - determines if and how the element is docked in slideshow container. Can have one of these values: top, bottom, left, right, none.

Example
$("#my-slideshow").slideshow({
	navigationLocation : {
		top: 50,
		left: 100,
		width: 200,
		height: 75,
		anchor: "top-right",
		dock: "none"
	}
);
Element is located 50 pixels to the left from the right slideshow edge and 100 pixels from the top slideshow edge. Elements width is 200 pixels and it's height is 75 pixels. It's anchored to the top-right slideshow corner and it's not docked.
data-navigationLocationString(empty string)
String that determines the navigation buttons location, it's dimensions, anchor and docking.

Those properties should be given in a one of these formats:
top,left,width,height,anchor,dock
top,left,width,height,anchor
top,left,width,height
top,left,width-and-height
top,left,anchor,dock
top,left,anchor
top,left

top and left - integers, position of element in pixels
width and height - integers, dimension of element in pixels or "auto" which is the default value if width and height is not given.
anchor - determines element's anchor, that is in which slideshow corner is the 0,0 location. Can have one of these values: top-left, top-right, bottom-left, bottom-right.
dock - determines if and how the element is docked in slideshow container. Can have one of these values: top, bottom, left, right, none.

Example
50,100,200,75,top-right,none - element is located 50 pixels to the left from the right slideshow edge and 100 pixels from the top slideshow edge. Elements width is 200 pixels and it's height is 75 pixels. It's anchored to the top-right slideshow corner and it's not docked.
linkSeparatorString<div class="link-separator">&nbsp;</div>
A string that determines the separator between slide links. It can be set by a member of slideshow constructor parameter or by defining HTML element with "link-separator" class as a child of a HTML element with "slideshow-container" class.
linksLocationObject(see details below)
Object that determines slide links container location, it's dimensions, anchor and docking.

Object available properties are: top, left, width, height, anchor and dock.

top and left - integers, position of element in pixels
width and height - integers, dimension of element in pixels or "auto" which is the default value if width and height is not given.
anchor - determines element's anchor, that is in which slideshow corner is the 0,0 location. Can have one of these values: top-left, top-right, bottom-left, bottom-right.
dock - determines if and how the element is docked in slideshow container. Can have one of these values: top, bottom, left, right, none.

Example
$("#my-slideshow").slideshow({
	linksLocation : {
		top: 50,
		left: 100,
		width: 200,
		height: 75,
		anchor: "top-right",
		dock: "none"
	}
);
Element is located 50 pixels to the left from the right slideshow edge and 100 pixels from the top slideshow edge. Elements width is 200 pixels and it's height is 75 pixels. It's anchored to the top-right slideshow corner and it's not docked.
data-linksLocationString(empty string)
String that determines slide links container location, it's dimensions, anchor and docking.

Those properties should be given in a one of these formats:
top,left,width,height,anchor,dock
top,left,width,height,anchor
top,left,width,height
top,left,width-and-height
top,left,anchor,dock
top,left,anchor
top,left

top and left - integers, position of element in pixels
width and height - integers, dimension of element in pixels or "auto" which is the default value if width and height is not given.
anchor - determines element's anchor, that is in which slideshow corner is the 0,0 location. Can have one of these values: top-left, top-right, bottom-left, bottom-right.
dock - determines if and how the element is docked in slideshow container. Can have one of these values: top, bottom, left, right, none.

Example
50,100,200,75,top-right,none - element is located 50 pixels to the left from the right slideshow edge and 100 pixels from the top slideshow edge. Elements width is 200 pixels and it's height is 75 pixels. It's anchored to the top-right slideshow corner and it's not docked.
loop
data-loop
Booleantrue
Indicates whether slideshow is looped or not.
navigationLocationObject(see details below)
Object that determines the navigation buttons container location, it's dimensions, anchor and docking.

Object available properties are: top, left, width, height, anchor and dock.

top and left - integers, position of element in pixels
width and height - integers, dimension of element in pixels or "auto" which is the default value if width and height is not given.
anchor - determines element's anchor, that is in which slideshow corner is the 0,0 location. Can have one of these values: top-left, top-right, bottom-left, bottom-right.
dock - determines if and how the element is docked in slideshow container. Can have one of these values: top, bottom, left, right, none.

Example
$("#my-slideshow").slideshow({
	navigationLocation : {
		top: 50,
		left: 100,
		width: 200,
		height: 75,
		anchor: "top-right",
		dock: "none"
	}
);

				Element is located 50 pixels to the left from the right slideshow edge and 100 pixels from the top slideshow edge. Elements width is 200 pixels and it's height is 75 pixels. It's anchored to the top-right slideshow corner and it's not docked.
			
data-navigationLocationString(empty string)
String that determines the navigation buttons container location, it's dimensions, anchor and docking.

Those properties should be given in a one of these formats:
top,left,width,height,anchor,dock
top,left,width,height,anchor
top,left,width,height
top,left,width-and-height
top,left,anchor,dock
top,left,anchor
top,left

top and left - integers, position of element in pixels
width and height - integers, dimension of element in pixels or "auto" which is the default value if width and height is not given.
anchor - determines element's anchor, that is in which slideshow corner is the 0,0 location. Can have one of these values: top-left, top-right, bottom-left, bottom-right.
dock - determines if and how the element is docked in slideshow container. Can have one of these values: top, bottom, left, right, none.

Example
50,100,200,75,top-right,none - element is located 50 pixels to the left from the right slideshow edge and 100 pixels from the top slideshow edge. Elements width is 200 pixels and it's height is 75 pixels. It's anchored to the top-right slideshow corner and it's not docked.
onAfterAnimation
data-onAfterAnimation
Functionnull
This function is called after the slide animation is completed.
onBeforeAnimation
data-onBeforeAnimation
Functionnull
This function is called before the slide animation is started.
onInit
data-onInit
Functionnull
This function is called when the slideshow is initialized, before the slide images are loaded.
onLinkClicked
data-onLinkClicked
Functionnull
This function is called when the user clicks the slide. If this function returns false, then the action (user redirection) is cancelled.
onLoad
data-onLoad
Functionnull
This function is called after the slideshow is initialized and after all slideshow images are completely loaded.

Example

$("#my-slideshow").slideshow({
	onLoad : function(){
		alert('All slides were loaded');
	}
);

Example 2

<div id="my-slideshow" class="slideshow-container"
	data-onLoad="alert('All slides were loaded');">
	<div class="slide">
		<img class="slide-content" src="big-buck-bunny/1.jpg" alt=""/>
	</div>
</div>
onPause
data-onPause
Functionnull
This function is called when the slideshow is paused (whether by user or programmatically).
onSlideChanged
data-onSlideChanged
Functionnull
This function is called when the current slide has changed.
onSlideLinkClicked
data-onSlideLinkClicked
Function(index)null
This function is called when the user clicks slide link. A zero-based index as a parameter is passed with this function call. Slide change procedure can be cancelled if this function returns false.

Example

$("#my-slideshow").slideshow({
	onLoad : function(index){
		alert('Slide link #' + (index+1) + ' was clicked');
		return (index % 2 == 0);
	}
);
In this example, animation to destination slide is cancelled for every odd index value.
onStart
data-onStart
Functionnull
This function is called when the slideshow starts (whether by user or programmatically).
pauseDuration
data-pauseDuration
Number (integer)5000
Number of milliseconds the pause between slide animation last.
showLabel
data-showLabel
Booleantrue
Indicates whether labels are visible.
showNavigation
data-showNavigation
Booleantrue
Indicates whether navigation buttons container is visible.
showLinks
data-showLinks
Booleantrue
Indicates whether slide links container is visible.
showOverlay
data-showOverlay
Booleantrue
Indicates whether overlay image is shown.
skin
data-skin
Stringdefault
A skin name used by the slideshow. Note, that CSS skin definition should be added to HTML document.
Slideshow Methods
List of methods available for the slideshow object.
Name Parameters Returns
nextvoid
Shows next slide in a queue. If current slide is the last one and loop config property is set to true, then the first slide is shown.

Example

$("#my-slideshow").slideshow().next();
pausevoid
Pauses the slideshow.

Example

$("#my-slideshow").slideshow().pause();
prevvoid
Shows prevoius slide in a queue. If current slide is the first one and loop config property is set to true, then the last slide is shown.

Example

$("#my-slideshow").slideshow().prev();
showSlideNumber slideIndexvoid
Shows slide with specified index (one based index).

Example

$("#my-slideshow").slideshow().showSlide(2);
startvoid
Starts the slideshow.

Example

$("#my-slideshow").slideshow().start();
Slider - Simple Slideshow Solution
at slider.codeplex.com