swipe.js文档及用法

最近的一个项目中使用到了swipe.js这个插件

感觉非常的好用的

官方网站

http://swipejs.com/

https://github.com/bradbirdsall/Swipe

简介

swipe.js是一个轻量级的移动滑动组件，支持触摸移动，支持响应式页面。

下面是从GitHub上翻译的用法和文档

用法

 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可以扩展可选参数-通过设置对象的键值对:

• startSlide Integer (默认:0) - Swipe开始的索引

• speed Integer (默认:300) - 前进和后台的速度，单位毫秒.

• auto Integer - 自动滑动 (time in milliseconds between slides)

• continuous Boolean (默认:true) -是否可以循环播放（注：我设置为false好像也是循环的）

• disableScroll Boolean (默认:false) - 停止触摸滑动

• stopPropagation Boolean (默认:false) -停止事件传播

• callback Function - 回调函数，可以获取到滑动中图片的索引.

• transitionEnd Function - 在最后滑动转化是执行.

举例、

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) {}
});

 

 

Swipe API

swipe扩展了几个函数，以便于更好的通过脚本来控制滑动。

prev() 上一页

next() 下一页

getPos() 返回当前div（class='wrap'的div）的索引

getNumSlides() 返回滑块总数（貌似无效）

slide(index, duration) 设置滑到的索引 (duration: 转化的速度，单位毫秒)

 

swipeDemo