Flexisel

A responsive carousel jQuery plugin...

All you have to do is call flexisel on your unordered list containing images. Call it on the

$(window).load

event (as opposed to the

$(document).ready

event so that Flexisel can calculate the width of the images and figure out how to space them out properly. For example...

$(window).load(function() {
  $("#myCarousel").flexisel();
});

Below is how you'd call it passing in all the options....

$(window).load(function() {
  $("#myCarousel").flexisel({
    visibleItems: 4,
    itemsToScroll: 3,
    animationSpeed: 400,
    infinite: true,
    navigationTargetSelector: null,
    autoPlay: {
      enable: false,
      interval: 5000,
      pauseOnHover: true
    },
    responsiveBreakpoints: { 
      portrait: { 
        changePoint:480,
        visibleItems: 1,
        itemsToScroll: 1
      }, 
        landscape: { 
        changePoint:640,
        visibleItems: 2,
        itemsToScroll: 2
      },
        tablet: { 
        changePoint:768,
        visibleItems: 3,
        itemsToScroll: 3
      }
    }
  });
});

Options

Below is a listing of some basic options you can set...

Option	Value	Default Value	Description	Example
visibleItems	Integer	4	Sets the initial number of visible items in the carousel	visibleItems: 5
itemsToScroll	Integer	3	Sets the initial number of items that you want to scroll. Note: This value will be overridden by responsive breakpoint settings at smaller or larger screen widths	itemsToScroll: 2
animationSpeed	Integer (in Milliseconds)	400	Sets the "speed" of the animation when the carousel navigates right or left.	animationSpeed: 1000
infinite	Boolean	true	Sets whether or not the carousel wraps infinitely	infinite: false
navigationTargetSelector	String (selector)	null	The left/right arrows will be added to the element with this selector instead of the default	navigationTargetSelector: '#navigation'
autoPlay	Object	autoPlay: { enable: false, interval: 5000, pauseOnHover: true }	Values for setting autoplay. The "enable" property must be true for this to apply	autoPlay: { enable: true, interval: 7000, pauseOnHover: false }
loaded	function	function(object) { }	Callback function that runs after the slider is loaded and initialized. A jQuery reference to the instance of the carousel is passed in as the first argument.	loaded: function(object) { console.log('Slider loaded...'); }
before	function	function(object) { }	Callback function that runs before a slide transition. A jQuery reference to the instance of the carousel is passed in as the first argument.	before: function(object) { console.log('Before transition...'); }
after	function	function(object) { }	Callback function that runs after a slide transition. A jQuery reference to the instance of the carousel is passed in as the first argument.	after: function(object) { console.log('After transition...'); }
resize	function	function(object) { }	Callback function that runs after a throttled resize event finishes. A jQuery reference to the instance of the carousel is passed in as the first argument.	resize: function(object) { console.log('After resize...'); }

Responsive Breakpoints

This is an object that specifies responsive breakpoints. You can name your objects whatever you want (the default names provided are "portrait," "landscape," and "tablet") and you can have as many or as few as you want (so you could add to or delete any of the defaults), but each one needs to have a "changePoint" a "visibleItems", and an "itemsToScroll" property. Those properties are required. The responsiveBreakpoints object sets the threshold of where the screen width falls below a certain width. So for example, the example default portrait responsive breakpoint will be applied to the carousel when the screen width is less than the changePoint value set for portrait. The number of items shown in this state will be whatever value is set for visibleItems and the number of items that scroll per click (or swipe) is set by the itemsToScroll property.

For example...

responsiveBreakpoints: { 
  portrait: { 
    changePoint:480,
    visibleItems: 1,
    itemsToScroll: 1
  }, 
  landscape: { 
    changePoint:640,
    visibleItems: 2,
    itemsToScroll: 2
  },
  tablet: { 
    changePoint:768,
    visibleItems: 3,
    itemsToScroll: 3
  }
}

The landscape responsive breakpoint will be applied when the screen width is greater than the width of the portrait changePoint value, but less that the width of the tablet changePoint value. Likewise, when the screen width falls below the tablet changePoint, the number of visibleItems set for the tablet event will be shown. The same is true for the portrait breakpoint. Usually, because the portrait responsive event is used to show portrait views on mobile phones, 1 is a good value to set for both visibleItems and itemsToScroll here. And remember you can pass as many or as few of these as you like in and you can name them whatever you want. So, for example, if you wanted to just have things only show 1 item on all views below a certain width you could pass in something like the following...

 responsiveBreakpoints: {
    mobile: {
      changePoint:768,
      visibleItems: 1,
      itemsToScroll: 1
    }
}

And then this will be the only point at which Flexisel changes.

View Demo | Buy Author a Coffee

9bitStudios/flexisel

Flexisel

Options

Responsive Breakpoints