swipe.js文档及用法

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

一、用法

Swipe只需添加很简单的一段代码即可，如下

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

以上代码是最初需要的结构--一系列元素包裹在两个容器中，你可以在wrap中添加任何你想要的内容。最外面的div（即slide）需要设置一下的js函数：

window.mySwipe = Swipe(document.getElementById(‘slider‘));

同样的，Swipe需要往样式表中添加一些代码

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

二、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)：滑动方法

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

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

或者举例

window.mySwipe = new Swipe(document.getElementById(‘slider‘), {
  startSlide: 2,
  speed: 400,
  auto: 3000,
  continuous: true,
  disableScroll: false,
  stopPropagation: false,
  callback: function(index, elem) {},
  transitionEnd: function(index, elem) {}
});

实例效果可以查看：http://www.jiawin.com/demos/swipe-mobile-touch-slider/index.html

实例效果下载网址：http://yunpan.cn/QazPw6F4mZKH6