Skip to content

edisplay/OwlCarousel2

 
 

Repository files navigation

Stories in Ready Build Status

Announcement.

Big announcement comming about maintainance of this project. Stay tuned!

Owl Carousel 2 Beta

Touch enabled jQuery plugin that lets you create a beautiful, responsive carousel slider. To get started, check out http://owlcarousel.owlgraphic.com.

Please consider that the project is still in beta. The current status of the milestones can be found here. If you want to use the latest development see building.

Quick start

Download the latest release and put the required stylesheet at the top of your markup:

<link rel="stylesheet" href="owlcarousel/owl.carousel.min.css" />

Put the script at the bottom of your markup right after jQuery:

<script src="jquery.min.js"></script>
<script src="owlcarousel/owl.carousel.min.js"></script>

Wrap your items (div, a, img, span, li etc.) with a container element (div, ul etc.). Only the class owl-carousel is mandatory to apply proper styles:

<div class="owl-carousel">
  <div> Your Content </div>
  <div> Your Content </div>
  <div> Your Content </div>
  <div> Your Content </div>
  <div> Your Content </div>
  <div> Your Content </div>
  <div> Your Content </div>
</div>

Call the plugin function and your carousel is ready.

$(document).ready(function(){
  $('.owl-carousel').owlCarousel();
});

Documentation

The documentation, included in this repo in the root directory, is built with Assemble and publicly available at http://owlcarousel.owlgraphic.com. The documentation may also be run locally.

Building

This package comes with Grunt and Bower. The following tasks are available:

  • default compiles the CSS and JS into /dist and builds the doc.
  • dist compiles the CSS and JS into /dist only.
  • watch watches source files and builds them automatically whenever you save.
  • test runs JSHint and QUnit tests headlessly in PhantomJS.

To define which plugins are build into the distribution just edit /_config.json to fit your needs.

Contributing

Please read CONTRIBUTING.md.

License

The code and the documentation are released under the MIT License.

Packages

No packages published

Languages

  • JavaScript 43.9%
  • Handlebars 29.5%
  • CSS 26.1%
  • HTML 0.5%