jQuery Waterwheel Carousel

Features & Customization

• Horizonal or vertical orientation.
• Manipulate the carousel with arrow keys on keyboard.
• Callback support for when items move in and out of the center position, and when a center item is clicked.
• Public API functions to reload the carousel and move it in either direction.
• Requires very little CSS and HTML.
• Rotate a high number of images without bogging down the browser.
• Speed, animation type, opacity, item positions, "curve", and distances are all tweakable.
• Images of different sizes (proportions) are supported.
• Images can "fade away" at the edge, or move to a hidden position behind the center item until they are rotated out again.
• Change the number of "flanking" items on either side of the center.
• Endless rotation, items will continue to wrap around to the opposite side.
• Works in Chrome, FireFox, Safari, and IE7+.
• jQuery 1.4 - 1.9 support.

• denizli escort
• denizli escort
• didim escort
• düzce escort
• edirne escort
• edirne escort
• edremit escort

How to Use

When you download the carousel, you will have an HTML file with an advanced demo of the carousel allowing you to dynamically tweak the settings. As with most jQuery plug-ins, this carousel requires the following you to add the necessary JS files, and include some CSS and HTML.

JavaScript

...
<!-- note: should work with jQuery 1.4 and up -->
<script type="text/javascript" src="http://code.jquery.com/jquery-1.9.1.min.js">
<script type="text/javascript" src="/jquery.waterwheelCarousel.min.js">
<script type="text/javascript">
  $(document).ready(function() {
    $("#carousel").waterwheelCarousel({
      // include options like this:
      // (use quotes only for string values, and no trailing comma after last option)
      // option: value,
      // option: value
    });
  });
</script>
...

CSS

...
<style type="text/css">
  #carousel {
    width:800px;
    height: 300px;
    display: relative;
  }
  #carousel img {
    display: hidden; /* hide images until carousel prepares them */
    cursor: pointer; /* not needed if you wrap carousel items in links */
  }
</style>
...

HTML

...
<div id="carousel">
<img src="/image1.jpg" alt="Image 1" />
<img src="/image2.jpg" alt="Image 2" />
<img src="/image3.jpg" alt="Image 3" />
<img src="/image4.jpg" alt="Image 4" />
<img src="/image5.jpg" alt="Image 5" />
</div>
...

OPTION

Below is a list of all the configurable options. I tried to give a good description to each, but if something is not clear, feel free to drop me an email or comment on the carousel's main page.

API Functions

To use these functions, you should assign the carousel to a local variable. For instance, you could initialize the carousel like this:var carousel = $('#carousel').waterwheelCarousel();. Then the functions on the carousel can be called like this: carousel.next().

Further explanation of callback functions

These functions are what really make the carousel useful, but may be tough to understand for people not used to the concept. Instead of a normal integer or string value passed in as an option, you are passing in a callback function. The function takes has parameter, which the carousel will use to place data about the image that was clicked. When certain events happen, the carousel will call the passed in function, passing in the item object. Here is an example:

$(document).ready(function () {
  $("#waterwheelCarousel").waterwheelCarousel({
    clickedCenter: function($clickedItem) {
      // $clickedItem is a jQuery wrapped object describing the image that was clicked.
      var imageUrl = $clickedItem.attr('src');
      alert('The center image was just clicked. The URL of the image is: ' + imageUrl);
    },
    movedToCenter: function($newCenterItem) {
      // $newCenterItem is a jQuery wrapped object describing the image that was clicked.
      var imageID = $newCenterItem.attr('id'); // Get the HTML element "id" for this image. Let's say it's "tigerpicture"
      // Now that we have the ID of the image, we can use jQuery to show the content corresponding to the tigerpicture.
      $('#'+imageID+'-information').show(); // this will show the HTML element with id of "tigerpicture-information" on your site.
    }
  });
});

This can be a bit confusing at first, but these functions will let you be very flexible with what the carousel can show/hide/load onto your site. If you wrap images with links, you can access the link simply by using $clickedItem.parent() or $newCenterItem.parent() (from the above example).

Further explanation of "linkHandling"

You can wrap all of the images in links if you'd like. Most people will probably want to add links around each image, but only activate the links when the center item is clicked. This is the default use case. However, you can turn all of the links off if you prefer using the callback functions to handle the links.