Read the latest web development and design tips at Fred Wu's new blog! :-)
Poke me on GitHub

Release: [jQuery Plugin] Slideshow Lite

Latest release: v0.5.3
Please check for the latest version on Github!

A few days ago I was asked to make a simple slideshow. My initial thought was, there must be a ton of solutions available for jQuery. I could easily draw inspiration from them.

I was wrong. Whilst there are a few nicely done slideshow plugins for jQuery, the majority of them are either poorly written or far too complicated.

So, I decided to code my own plugin from the ground up. Meet Slideshow Lite!

The plugin is only tested with jQuery 1.3, but it should also work on jQuery 1.2.


  • Unobtrusive JavaScript, simply load it and that’s it
  • Clean, semantic HTML structure
  • Easy to use
  • Customisable
  • Free to use or to modify (GPL/MIT dual license)!

Plugin Options

  • pauseSeconds (float) – number of seconds between each photo to be displayed
  • fadeSpeed (float) – number of seconds for the fading transition, the value should not exceed ‘pauseSeconds’
  • width (integer) – width of the slideshow, in pixels
  • height (integer) – height of the slideshow, in pixels
  • caption (boolean) – display photo caption?
  • cssClass (string) – name of the CSS class, defaults to ‘slideshowlite’


	// with default options

	// with custom options
		pauseSeconds: 4,
		height: 200

Please checkout the demo for the HTML required.


Click here for a simple demo.

Download / Source Code
Please check for the latest version on Github!


v0.5.3 [2009-09-24]

  • Added ‘fadeSpeed’ for setting the transition speed.

v0.5.2 [2009-09-06]

  • Repackaged to remove an unnecessary .htaccess file.

v0.5.1 [2009-08-30]

  • Fixed some typo.

v0.5 [2009-08-29]

  • Major rewrite: slides can now be clicked freely (as opposed to waiting for one to finish showing before it can be clicked again).
  • Added automatic photo caption.

v0.4 [2009-08-05]

  • Code clean up.
  • Added transparency effects to the navigation, to indicate when it is clickable.
  • Added inline configuration documentation.

v0.3 [2009-08-04]

  • Smoother animation.

v0.2 [2009-08-04]

  • Fixed a navigation bug where the clicks no longer work after clicking on the current slideshow.

v0.1 [2009-08-04]

  • Initial release.
  • Digg
  • DZone
  • Facebook
  • Mixx
  • Google Bookmarks
  • LinkedIn
  • Live
  • Reddit
  • Slashdot
  • StumbleUpon
  • Technorati
  • Twitter

Related posts

Tags: , , , , , ,

Comments Section

63 Responses to “Release: [jQuery Plugin] Slideshow Lite”

Sidebar might be covered by comments ... consider it a feature! ;)
  1. 1


  2. 2



  3. 3


  4. 4

    Hi, i am using your slide show function in our company’s website. Your newest log said that you added a function to indicate the buttons when they are clickable. However, i want the digit buttons are able to be clicked anytime. At this moment, If i clicked “2″, i have to wait for the slide to change and then i can click the other digits. Can you let me know how i can disable this function. I am sorry about this because i am a newer to the JQ. Thank you

  5. 5

    @Francis: This feature is not currently available, but is planned for a future release.

  6. 6


  7. 7

    @pidan: 暂时不行,不过我会考虑在未来版本中添加此功能。

  8. 9

    Version 0.5 is released! :)

  9. 10

    Nice work Fred !

    How can I easily turn off the ‘numbered boxes’ ?

  10. 11

    I can probably add a switch in a future release, but for now, if you want to disable the pagination, simply add ‘display: none;’ to ‘.slideshowlite ul’ in your CSS file.

  11. 12

    This thing’s really hot but it just won’t work in my home Apache server installation (WAMP5) and not on my webhosting server either. If I attempt to open the index file directly from my hard drive, it loads the script normally and runs the slideshow. If I open the page from either server, it looks like a flash-of-unstyled-content… See for yourself! — any help appreciated ;)

  12. 13

    Under the ‘js’ directory there is a hidden ‘.htaccess’ file, delete that file and it will work fine. Alternatively, I have repackaged the files (v0.5.2), you can download it again. :-)

  13. 14

    Oh boy, that did it! But wait, wasn’t that .htaccess supposed to *stay* there?

    We’re selecting a slideshow script like this for our website. Right now I’m stick with Slideshow Lite and also testing EasySlider. Since they display different effects it’ll be pretty much a matter of taste for the guys at the office, I’ll post a link here if we end up using Slideshow Lite, I think you’ll like the result.

  14. 15

    Umm. By “stick with” I meant “sticking to” and not “stuck with” by the way. :)

    I really found this script to be ultra useful.

  15. 16

    I’m glad you find the script useful Rafael. And no the .htacccess file was included by mistake. :)

  16. 17

    Hi, Thanks alot
    But I need put swf file not image!

    so I use , not use

    what I do?

    Thank you so much

  17. 18

    Oh sorry! some tags is disappear!
    this my msg with change in tags:
    Hi, Thanks alot
    But I need put swf file not image!

    so I use , not use

    what I do?

    Thank you so much

  18. 19

    I am so so sorry!
    Oh sorry! some tags is disappear!
    this my msg with change in tags:
    Hi, Thanks alot
    But I need put swf file not image!

    so I use [ embed ], not use [ img ]

    what I do?

    Thank you so much

  19. 20

    Flash content is not supported at the moment, but I’d be happy to look into this. :-)

  20. 21

    No, I just say this idea
    Thanks alot
    but make this in your mind if you need upgrade your code!

    Good luck

  21. 22

    Hi Fred, many thanks for this script and all your hard work – it really is excellent esp for people new to web development. Have a strange glitch in Fire Fox – have turned off the pagination and the captioning and a strange number “2″ appears in the top right hand corner of the image. Weird Huh – doesn’t occur in Safari either. Yet to test on IE. Any ideas?

  22. 23

    How did you turn off the pagination and the caption? Or, could you provide a link to your slideshow page?

  23. 24


  24. 25

    Hi Fred,

    some links to the demo page of your plugin are broken.
    JQuery-Homepage -> your DemoSite
    your site ( below the scriptexample) -> your demo page

    Thanks for the nice plugin,

  25. 26

    @sky: 等有时间后我会在IE8下进行测试。

    @Caddy: Nice catch! The demo links are now fixed. Thanks. :)

  26. 27

    Thanks a ton for this. Very cool slider.

  27. 28


    Im currently using your scipt on one of my web sites. Is there anyway that we can slow the transition time from one image to another?

  28. 29

    Plugin updated to 0.5.3, you can now set the ‘fadeSpeed’ parameter for the transition speed. :-)

  29. 30

    Hi guys

    i have use this slideshow.its amazing and thankyou

    and now i just needed to add play and pause button to this slideshow is there any eazy way to do it

    pls regard this

    thank you

  30. 31

    Hi Roshan,

    There is no immediately plans to implement play/pause feature, but you’re welcome to contribute.

    Have a look at ‘clearTimeout()’:

  31. 32


    I’m really interested in your slideshow lite gallery as most other galleries out there seem to be rather cluttered and over the top; yours is very clean and simple which is great. I want to put the slideshow into a div in my website (that’s currently under construction). However, I’m rather new to all this stuff. I’ve been working through trying to understand CSS and the like. Is there an easy way you can explain how to get your plugin working within a div? Basically, for me, the div (which currently just has a single image in it) has an id tag set in the CSS which positions it correctly. If I have ‘slideshow’ as the id, where do I put all the CSS styles for that new id?

    I’m sure this is probably a stupid question… I’m sorry! But any pointers would be really gratefully received!


  32. 33

    @Edward: Slideshow Lite needs its own div container, in your case you can simply make a another div that wraps around the slideshow div. Or, you can simply target your div ID in the JavaScript, i.e. $(“#your-div-id”).slideshow();

  33. 34

    Absolutely love this slider.
    I was wondering of there is a way to make the caption text appear opaque at the moment its see thru the same amount as the background box.


  34. 35

    @jacob, I might add an option later, but for now, you can simply comment out line 88 and line 89:

    pagination.fadeTo(0, 0.8);
    caption.fadeTo(0, 0.6);


  35. 36


  36. 37


    is it possible to disable the 1 – 2 – 3 – 4 options in the bottom of the image?


  37. 38

    Yes, set the ‘caption’ option to false.

  38. 39

    Great slideshow.
    Just wondering if why it always opens in a new window/tab when you click on the image, anyway to turn it off?
    Any plans to include image pre-loading, for startup speed?

  39. 43


  40. 44

    Hello! Thank you for the plugin! I just have a problem – how I could remove page numbers’ opacity? Their background is too transparent :(.

  41. 45

    Hi I was wondering if there is an easy way to have the slideshow pause when moused over or perhaps only play through once.


  42. 46

    Hello, working on a site for a non-profit, where I use this slideshow… I love it and works amazing in firefox and safari, my only concern/question, is that it is not displaying correctly in Internet Explorer… here is the link

    What am I doing wrong here?


  43. 47

    Love this script!

    Does anyone know of a way to override IE’s pesky ActiveX Controls blockage?

  44. 49

    Just a quick question… How do you make the slideshow swing or slide to the left, instead of a cross dissolve?


  45. 50

    I’d like to direct this inquiry to Fred Wu or anyone else that might have some input.

    This Slideshow Lite looks very good — I haven’t tried using it yet, but it’s close to another style slideshow, or light box, that I like very much. The one I’m referring to is in use on in the upper left corner.

    Is this one basically the same as Slideshow Lite? What might I have to do differently or change in Slideshow Lite to get the same effect as the one on the Forbes site?

    Please advise when possible.

    Thanks, Vinnie.

  46. 51

    Very nice slide show! I have a request. Is there a way to add different kinds of transitions other than the standard fade? For instance, one of my customers wants a way to replace the fade transition with one where it appears as if the current photo is being “peeled away” to show the next photo beneath it. A “curl” on the corner of the photo that peels away the top photo diagonally would be perfect.

  47. 52

    好像不支持最新的 Jquery 1.4.4
    It counld not work in Jquery 1.4.4

  48. 53

    @ajings, are you using the latest version from Github?

    I’m using it with jQuery 1.4.4 and it works fine. What sort of issues did you run into?

  49. 54


  50. 55

    还有一个问题补充一下,希望作者出下一个版本的时候,点击按钮也同样有淡入淡出的效果(正倒序都有),本人按照作者的代码稍微进行改动,正序点击的时候有了淡入淡出效果了,但是倒序点击就没有任何效果,再经过费脑筋后倒序点击勉强有了效果,但是跟正序有点不太一样啊(my god~囧)。还有一个小小要求就是:鼠标移到图片上面的时候不让自动切换图片。最好设计成能自己在参数那边能控制这个情况下自动走还是不走。希望作者快去接着做呀,谢谢你拉,真急用!

  51. 56

    Hello- Is there a way to make the slide show appear just on the home page without showing on the rest of the pages? Thank you.

  52. 57


  53. 58

    請問 黑框線條可以去掉?


  54. 60

    Hello- Is there a way to make the slide show appear just on the home page without showing on the rest of the pages? Thank you.

  55. 61

    Great slider! So simple I love it.
    One question. I’m trying to add a line break in the caption so I can have a caption title. Line break and the utf line break doesn’t work at all with the alt tag so I changed it to title – works on the hover but not in the caption. Changed to name so it shouldn’t be tied to any standards – same result. Is there a simple way to either add a line break or use another attribute to add a header? I’m terrible with js! OH! also, over time the pix speed up and the titles all come in at once.