Note: This is under active development. Check the gallery-slideshow/tests folder for the most current examples on how this module works.

The base implementation of Slideshow is designed to be as simple as possible, supporting displaying a series of images of identical size that cycle through the selection, optionally applying a supplied animation for the transition between images.

Future developments will use the plugin architecture to modify the behaviour to support things like images of different sizes and such.

Supported Attributes (above what Widget supports):

• images: An array of objects offering information about the images. See below
• anim: The animation to apply, must be an instance of Y.Anim
• delay: The time in milliseconds to display an image before beginning to transition to the next
• image_height: The height of the image area of the widget. This should be smaller than the overall height, if set.
• image_width: The width of the image area of the widget. This should be smaller than the overall width, if set.
• title: The title to apply to the slideshow.

The Images structure:

• src: The URI to load in the image tag

There are currently two plugins available for Slideshow,
1. gallery-slideshow-image-scaler

This plugin will use the height and width properties for each item in the Images structure (or default values you provide when instantiating the plugin) to scale using CSS each image. Usually this isn't the correct thing to do.

2. gallery-slideshow-image-padder

This plugin will apply padding around each image in order to center it in the content body area of the widget. This allows for slideshows to consist of images of different sizes cleanly, though it does require the background-color property on the .yui-slideshow-body to be set.