Bway Image Slider v1.0.6  [jQuery plugin]

Allows vertical or horizontal axis usage.

Very easy to use and responsive jQuery image slider plugin with option for Horizontal or Vertical axis and infinite loop.
Includes also touch events, and current/total information.

v1.0.6 Loader controlable. Since you have .loader-overlay in your container just use loader : true. (we are using some css loaders from the awesome SpinKit project)

v1.0.5 Different objects size allowed in 'x' axis.

v1.0.4 Allows keyboard controls. keyboard : true

v1.0.3 Includes image counter. Just needs to include .image-current and .image-total classes.

v1.0.2 Allows <a> or <img> as list elements.

v1.0.1 Enables touch actions, using jquery.hammer.js

Download

You can Download this plugin from our github repository.

Setup...

Load jQuery and include bway-image-slider plugin

<script src="//ajax.googleapis.com/ajax/libs/jquery/1.11.2/jquery.min.js"></script>
<script src="jquery.bway.imageslider.min.js"></script>

If you want touch events, please load also hammer.js before this plugin, as you see in the lines below:

<script src="//ajax.googleapis.com/ajax/libs/jquery/1.11.2/jquery.min.js"></script>
<script src="//cdn.jsdelivr.net/g/hammerjs@2.0.4,jquery.hammerjs@2.0.0"></script>
<script src="jquery.bway.imageslider.min.js"></script>

Place your HTML markup

with <img> elements (in this example we are including a loader)
for this and other loader code visit this project 

<div id="your-gallery">
  <div class="viewport">

    <!-- LOADER (optional) -->
    <div class="loader-overlay">
      <div class="sk-circle">
        <div class="sk-circle1 sk-child"></div>
        <div class="sk-circle2 sk-child"></div>
        <div class="sk-circle3 sk-child"></div>
        <div class="sk-circle4 sk-child"></div>
        <div class="sk-circle5 sk-child"></div>
        <div class="sk-circle6 sk-child"></div>
        <div class="sk-circle7 sk-child"></div>
        <div class="sk-circle8 sk-child"></div>
        <div class="sk-circle9 sk-child"></div>
        <div class="sk-circle10 sk-child"></div>
        <div class="sk-circle11 sk-child"></div>
        <div class="sk-circle12 sk-child"></div>
      </div>
    </div>
    <!-- end of LOADER (optional) -->

    <input type="button" class="buttons prev" value="<">
    <ul class="overview">
      <li><img src="path-to-your-image"></li>
      <li><img src="path-to-your-image"></li>
      <li><img src="path-to-your-image"></li>
      <li><img src="path-to-your-image"></li>
    </ul>
    <input type="button" class="buttons next" value=">">
  </div>
</div>

or if you prefer <a> elements (in this example we are NOT including a loader) 

<div id="your-gallery">
  <div class="viewport">
    <input type="button" class="buttons prev" value="<">
    <ul class="overview">
      <li><a href="#" style="background-image: url('path-to-your-image');"></a></li>
      <li><a href="#" style="background-image: url('path-to-your-image');"></a></li>
      <li><a href="#" style="background-image: url('path-to-your-image');"></a></li>
      <li><a href="#" style="background-image: url('path-to-your-image');"></a></li>
    </ul>
    <input type="button" class="buttons next" value=">">
  </div>
</div>

Initialization

Simple initialization

$('#your-gallery').bwayImageSlider();

initializing with some options

$('#your-gallery').bwayImageSlider({
  axis       : 'y',  // default 'x'
  itemMargin : 14,   // margin between items, default 10
  speed      : 500,  // miliseconds, default 1500
  loop       : true,
  keyboard   : true,
  loader     : true
});

Examples

Below you can find an example of the plugin in vertical and horizontal axis, both with the possibility of infinite loop.

HORIZONTAL (no loop)

$('#example1').bwayImageSlider({
  axis       : 'x',
  itemMargin : 14,
  speed      : 500,
  loop       : false,
  keyboard   : true,
  loader     : true
});

HORIZONTAL + INFINITE LOOP

$('#example2').bwayImageSlider({
  axis       : 'x',
  itemMargin : 14,
  speed      : 500,
  loop       : true,
  keyboard   : true,
  loader     : true
});

VERTICAL (no loop)

with <a> elements

$('#example3').bwayImageSlider({
  axis       : 'y',
  itemMargin : 14,
  speed      : 500,
  loop       : false,
  loader     : true
});

VERTICAL + INFINITE LOOP

with <img> elements

$('#example4').bwayImageSlider({
  axis       : 'y',
  itemMargin : 14,
  speed      : 500,
  loop       : true,
  loader     : true
});

License

The JavaScript code in this page is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License (GNU GPL) as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. The code is distributed WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU GPL for more details.

As additional permission under GNU GPL version 3 section 7, you may distribute non-source (e.g., minimized or compacted) forms of that code without the copy of the GNU GPL normally required by section 4, provided you include this license notice and a URL through which recipients can access the Corresponding Source.

Contribute

If you find this plugin useful, you can donate on the link below. Thank you.