Another jQuery carousel plugin!
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
LICENSE.md
README.md
jquery.dbpas.carousel.css
jquery.dbpas.carousel.js

README.md

dbpasCarousel

Another jQuery carousel plugin!
Inspired by this web.enavu.com article.

###Overview This plugin will convert the ul element into a carousel.

Demo

###Install

<head>
  ...
  <link rel="stylesheet" type="text/css" href="jquery.dbpas.carousel.css" />
  <script src="//ajax.googleapis.com/ajax/libs/jquery/2.0.2/jquery.min.js"></script>
  <script src="javascripts/jquery.dbpas.carousel.js"></script>
  <script>
    $(document).ready(function() {
      $('ul').dbpasCarousel({options});
    });
  </script>
  ...
</head>

###Options ####Default |Option |Description |Type |Default | |---------------|-----------------------------------------------------------------------------------------|----------|--------| |itemsVisible |Number of items to display. |int |2 | |slideDelay |This is the carousel animations duration, in milliseconds. |int |500 | |autoSlide |Move carousel without user interaction when page is ready. |boolean |0 | |autoDelay |The frequency the auto slide moves the carousel, in milliseconds. |int |5000 | |hoverPause |Pause auto slide when hovering over carousel. |boolean |1 | |imgCaption |Auto generate captions for each slide using img alt attribute. |boolean |1 | |onComplete |callback function |function|null | ####Special If you need to remove the plugin from your page, use destroy.

$('ul').dbpasCarousel('destroy');

###Usage ####Simple Images Place your images into the li elements.

<body>
  ...
  <ul>
    <li><img src="http://lorempixel.com/100/100/abstract" alt="image 1" /></li>
    <li><img src="http://lorempixel.com/100/100/animals" alt="image 2" /></li>
    <li><img src="http://lorempixel.com/100/100/nature" alt="image 3" /></li>
    <li><img src="http://lorempixel.com/100/100/people" alt="image 4" /></li>
  </ul>
  ...
</body>

####Varying Content Wrap your content with a div and place it into the li elements.

<body>
  ...
  <ul>
    <li>
      <div>
        <h3>Paragraph 1</h3>
        <p>
          Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum accumsan sapien congue, iaculis sem at, blandit tortor. Vestibulum eget orci a leo mattis commodo ut quis diam. Nullam porttitor tempus nunc, ac luctus lectus euismod eget. Vestibulum vestibulum neque vel enim condimentum consequat. Mauris gravida eros sapien, id bibendum nunc vulputate quis. Nam facilisis turpis ligula, vitae bibendum elit adipiscing ac. Phasellus id lectus varius, imperdiet urna vitae, ornare est.
        </p>
      </div>
    </li>
    <li>
      <div>
        <h3>Paragraph 2</h3>
        <p>
          Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum accumsan sapien congue, iaculis sem at, blandit tortor. Vestibulum eget orci a leo mattis commodo ut quis diam. Nullam porttitor tempus nunc, ac luctus lectus euismod eget. Vestibulum vestibulum neque vel enim condimentum consequat. Mauris gravida eros sapien, id bibendum nunc vulputate quis. Nam facilisis turpis ligula, vitae bibendum elit adipiscing ac. Phasellus id lectus varius, imperdiet urna vitae, ornare est.
        </p>
      </div>
    </li>
    <li>
      <div>
        <h3>Paragraph 3</h3>
        <p>
          Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum accumsan sapien congue, iaculis sem at, blandit tortor. Vestibulum eget orci a leo mattis commodo ut quis diam. Nullam porttitor tempus nunc, ac luctus lectus euismod eget. Vestibulum vestibulum neque vel enim condimentum consequat. Mauris gravida eros sapien, id bibendum nunc vulputate quis. Nam facilisis turpis ligula, vitae bibendum elit adipiscing ac. Phasellus id lectus varius, imperdiet urna vitae, ornare est.
        </p>
      </div>
    </li>
    <li>
      <div>
        <h3>Paragraph 4</h3>
        <p>
          Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum accumsan sapien congue, iaculis sem at, blandit tortor. Vestibulum eget orci a leo mattis commodo ut quis diam. Nullam porttitor tempus nunc, ac luctus lectus euismod eget. Vestibulum vestibulum neque vel enim condimentum consequat. Mauris gravida eros sapien, id bibendum nunc vulputate quis. Nam facilisis turpis ligula, vitae bibendum elit adipiscing ac. Phasellus id lectus varius, imperdiet urna vitae, ornare est.
        </p>
      </div>
    </li>
  </ul>
  ...
</body>

###Tips

  • Items disappear before the carousel moves; make sure to leave at a minimum 2 items out of view.
  • If the formatting looks bad, be sure to setup css default overrides. Look to this [data-carousel-control="wrapper"] ul li or [data-carousel-control="wrapper"] ul li div selectors to fix most of your issues.