移动端h5轮播插件swipe

在移动端的h5页面里，我们经常会有轮播图的需求，如果不需要太多的效果，只是简单的手指滑动和自动轮换效果的话，我比较推荐swipe插件，不过百度搜索到的这个插件，里面介绍的不是很完整，我给大家补充下可能需要的功能。

swipe.js是一个轻量级js触摸滑动类库 – Swipe JS。这是一个非常小的一个javascript类库，但他的功能却不简单，它可以用来展示web页面上的任何内容，支持精确的触摸移动操作，而且还可以设置自动播放、等比例缩放等等实用性的功能。

Swipe函数介绍

下面就为大家介绍下Swipe JS的使用方法，Swipe有以下几个参数：

startSlide: 4,  //起始图片切换的索引位置
auto: 3000, //设置自动切换时间，单位毫秒
continuous: true,  //无限循环的图片切换效果
disableScroll: true,  //阻止由于触摸而滚动屏幕
stopPropagation: false,  //停止滑动事件
callback: function(index, element) {},  //回调函数，切换时触发
transitionEnd: function(index, element) {}  //回调函数，切换结束调用该函数。

除此之外，还有一些比较常用的API方法，例如：

• prev()：上一页
• next()：下一页
• getPos()：获取当前页的索引
• getNumSlides()：获取所有项的个数
• slide(index, duration)：滑动方法

Swipe使用方法

了解基本函数方法后，我们就来看看使用方法。

首先是HTML结构：

<div id="slider" class="swipe">
  <div class="swipe-wrap">
    <div></div>
    <div></div>
    <div></div>
  </div>
</div>

然后是样式代码：

.swipe {
	overflow: hidden;
	visibility: hidden;
	position: relative;
}
.swipe-wrap {
	overflow: hidden;
	position: relative;
}
.swipe-wrap > figure {
	float: left;
	width: 100%;
	position: relative;
}

最后设置JS绑定以及参数设置：

var slider = Swipe(document.getElementById('slider'), {
   …………
   …………
});

在这里只要把上面介绍的函数参数写在里面，就可以实现相对应的功能。

最后我们也可以给滑动切换添加上下按钮：

<button οnclick="Swipe.prev()">prev</button>
<button οnclick="Swipe.next()">next</button>

另外我进行一些分页器效果的补充吧：

如果需要分页那个点的效果的话，可以这么添加代码：

nav标签部分就是分页器的相关部分拉，多少个slide就多少个li标签（如果需要分页器效果的童鞋就添加一个nav和ul标签即可，因为代表分页点的li标签需要动态生成，如果你是动态添加的轮播模块！）

接着swipe实例对象初始化配置：

如果你是动态生成的轮播模块，就添加上红色圈出来的部分，反之则不用

还有个关键的地方，这个插件在手指滑动过一次slide模块后就会stop了，不会再自动轮播，这时候需要到swipe.js里去修改一下源码：

这样这个插件基本就能正常运行满足你最基本的需求。