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

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

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结构:

然后是样式代码:

.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'), {

…………

…………

});

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

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

next

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

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

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

对应的实例化代码(有更简化写法的童鞋可以用自己的方法):

var slider = Swipe(document.getElementById('slider'), {
auto: 3000,
continuous: true,
callback: function(pos) {
var i = bullets.length;
while (i--) {
bullets[i].className = ' ';
}
bullets[pos].className = 'on';
}
});
var slides = document.querySelectorAll('.swipe-wrap figure').length;
var liBox = document.getElementById('position');
var liTab;
for (var i = 0; i < slides; i++) {
liTab = document.createElement('li');
if (i == 0) {
liTab.className = 'on';
}
liBox.appendChild(liTab);
};
var bullets = document.getElementById('position').getElementsByTagName('li');

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

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