This is a generic carousel widget which can be used with any content. Highly customizable and extendable. It works in any browser on any device.

Your pull requests are more than welcome and we're happy for any contribution.

Below is a sample of how you create a simple image carousel. Add the script to the bottom of the page

<script src="carousel-1.0.0.min.js"></script>

Then add markup for listing the images.

<div>
    <div id="imageList">
        <img src="" alt="">
        <img src="" alt="">
    </div>
    <div id="prevNextNavigation" class="nextprev">
        <a class="prev" title="Previous"><span class="hidden">Previous</span></a>
        <a class="next" title="Next"><span class="hidden">Next</span></a>
    </div>
</div>

Now let's wire up the JS code required to make this thing work. This should be in a separate file loaded after the carousel lib.

(function(carousel){
    var sourceImageList = document.getElementById("imageList");
    var imageList = carousel.elementList.create(sourceImageList);
    var controller = carousel.controller.create(imageList);

    var imageProjector = carousel.animatedProjector.create(controller, imageList, {
        duration: 500,
        animator: carousel.horizontalSlider
    });
    var imageCarousel = imageProjector.buildCarousel();
    carousel.setupClickNavigation(
        controller,
        imageList,
        document.getElementById("prevNextNavigation")
    );
    carousel.setupKeyboardNavigation(controller);
    carousel.setupTouchNavigation(controller, imageCarousel);
    sourceImageList.style.display = "none";

    controller.start();
}(FINN.carousel));

That's it! You can use this same setup for things other than images, you can loop through any type of DOM node. Wether it's an image, canvas, svg or whatever.

The carousel consists of many components which can easily be composed together to give the carousel different behaviours. Below are some samples, the rest is in the source code.

There are a few samples in the samples folder which shows how you can combine the different components to fit your requirements.

Feel free to add your samples to this section or let us know if you use it.

• Show cases module uses the carousel to provide users with the option to view success stories (towards the bottom)
• Simple gallery just a simple image gallery with keyboard and touch navigation
• Gallery with thumbnail strip gallery with a simple thumbnail strip

###Preparing the workspace You will need Node/NPM and Grunt installed. Install required development dependencies:

$ cd carousel-js && npm install
$ npm install -g grunt grunt-cli
$ grunt

This runs tests and puts a new package in your local dist folder, ready to use.

Currently all tests are run using Karma runner. Tests use the Buster assertion library and Jasmine for writing tests. Jasmine was selected due to the fact it helped us move away from JsTestDriver.

    $ npm test

    $ grunt karma

    $ ./node_module/.bin/karma start

The carousel package contains numerous components which can be packaged together to give you exactly the kind of carousel widget you want.

• Bane
• jQuery 1.7 and up

Some components rely on jQuery, we are working to lose those as soon as possible.

What about AMD support?

The pieces which make up the carousel widget are not AMD modules. However if you have a look in the samples directory you can se how to use the widget in an AMD environment

Other module formats can take similar approaches. There are currently no plans to expose the individual modules in the carousel to different module formats.

I get an error with the bind function

The carousel requires an ES5 shim to be present for browsers which doesn't have the bind function available.

• Magnar Sveen
• Christian Johansen
• Jostein Holje