Carousel

A slideshow component for cycling through elements (images or slides of text) like a carousel.

Around component

You can alter carousel look and behaviour via modifier CSS classes and flexible data API.

Basic HTML structure:
<div class="cs-carousel">
  <div class="cs-carousel-inner" data-carousel-options='{}'>
    <!-- Carousel slides here -->
  </div>
</div>
Modifier classes:
  • cs-controls-center - Center align controls (prev/next buttons).
  • cs-controls-left - Left align controls (prev/next buttons).
  • cs-controls-inside - Position controls (prev/next buttons) absolutely on top of the carousel content (on sides). Will not work with the above positioning classes.
  • cs-controls-onhover - Show controls (prev/next buttons) only when user hovers over the carousel. Works only with cs-controls-inside
  • cs-dots-inside - Position dots absolutely on top of the carousel content.
  • cs-dots-light - Switch dots skin to light version.
Data API:
data-carousel-options = '{}':
  • "mode": "carousel" | "gallery" - With carousel everything slides to the side, while gallery uses fade animations and changes all slides at once.
  • "axis": "horizontal" | "vertical" - The axis of the slider.
  • "items": 1 - How many items to display
  • "nav": true/false - Enable/disable dots control
  • "controls": true/false - Enable/disable prev / next arrow buttons
  • "loop": true/false - Enable/disable infinite loop
  • "speed": 300 - Speed of the slide animation (in "ms")
  • "autoplay": true/false - Toggles the automatic change of slides
  • "autoplayTimeout": 5000 - Timeou between transition. Value in ms | 1000ms = 1s
  • "gutter": 0 - Space between carousel items (in px)
  • "autoHeight": true/false - Height of slider container changes according to each slide's height.
  • "responsive": {"0": {"items": 1}, "768": {"items": 2}, ...} - How many items to display on each screen size. Options are not limited to number of items. You can change any option based on screen size.
  • For more options please visithttps://github.com/ganlanyuan/tiny-slider#options
Layer animation classes:
  • cs-from-top
  • cs-from-bottom
  • cs-from-left
  • cs-from-right
  • cs-scale-up
  • cs-scale-down
  • cs-fade-in
  • cs-delay-1
  • cs-delay-2
  • cs-delay-3
  • cs-delay-4
Top