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