Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master

This branch is 1 commit ahead of rahuldsg:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.

jQuery.slideShow, Readme File:

2010-08-22, Marcel Eichner // Ephigenia


This is a very simple and very easy to use slideshow plugin for jquery. It will automatically create a slideshow with navigation out of your image list. The plugin also provides different callbacks and options that let you customize the way the slideShow react on mouse rollovers, clicks or slideChanges.

If you downloaded this file with the sources you should visit jQuery.slideShow on github.

The script is licensed under MIT License and you can use it for free! All Images used are taken from the plugin’s author Marcel Eichner.


Want your site added to the list? Send me a message on github!


  • No DOM Tree manipulation or replacements
  • Lots of options and callbacks to modify and extend slidshow
  • Auto-Repeat, next, previous, stop and play
  • Random start slide
  • Navigate to slides via navigation links, hover cursor position
  • Automatic slide size detection, event works with different heights
  • Instance of slideshow returned, manipulating slideshow via JS


There are a lot of examples in the examples/ directory in the release showing how to use differnt options, alternate navigations and using of the slideshow instances.

var slideShow = $('div.slideShow').slideShow();


  • start [integer|string, default: 0]
    index of slide to start with. Set to random or rnd to select a random start slide
  • interval [integer, default: 3]
    seconds to wait before new slide starts
  • repeat [boolean, default: true]
    indicates if the slideshow should start new when reached the last slide
  • transition
    • mode [string, default fade]
      transition mode for slide changes
    • speed [integer, default 1000]
      speed of transition
  • slideSize [array, default auto]
    size of slides to use, default is auto, which will determine the size of the slide automatically
    • width [integer]
    • height [integer]
  • slideClick [callback]
    custom callback called when a slide is clicked
  • gotoSlide [callback]
    custom callback called when a new slide is triggered


If you found a bug, check out for updates or anything else on this project please visit the jquery.slideShow Project Page on Github and post it there under "issues".


  • 2010-10-08

    • Fixed Issue 1 "ply/pause button not working" by using the right interval property in the code
  • 2010-09-25

    • Added OPTIONS and USAGE part in this file
  • 2010-09-16

    • Added feature where the height of the slideshow is dynamically changed if the slides change their height. That is especially helpful for slides with alt image texts
    • Moved example display to the top and example description and source to bottom on every example source
    • Added example for thumbnail navigation
    • Fixed bug where first selected item gets deselected on init
    • Slideshow stop stops also in safari
  • 2010-08-22

    • Created repository on Github
    • Split examples into single files
  • 2010-04-06

    • fixed bug in navigation click with numbers when slideshow skipped to slide +1
  • 2009-11-25

    • fixed single equal sign in random start mode (thanks to Jean-Philippe)
  • 2009-10-22

    • added method for toggling slideshow playback (togglePlayback)
    • added method for reading playback status of slideshow
    • added example for this to the project page
    • changed format of this changelog to markdown
    • Random slideshow possible
  • 2009-07-20

    • fixed bug: use of images in navigation, click on .page fixed index
  • 2009-07-02

    • added license information and minified version of slideshow javascript
Something went wrong with that request. Please try again.