插件下载地址
官网:http://www.swipejs.com
github:https://github.com/bradbirdsall/Swipe
插件特色
swipe.js是一个比较有名的触摸滑动插件,它能够处理内容滑动,支持自定义选项,你可以让它自动滚动,控制滚动间隔,返回回调函数等。经常可见使用在移动开发中
使用方法
HTML代码如下:
<div class='swipe'>
<div class='swipe-wrap'>
<section>第1</section>
<section>第2</section>
<section>第3</section>
</div>
</div>
CSS代码如下:
*{ padding:0; margin:0; } html,body{ height:100%; } .swipe { overflow: hidden; visibility: hidden; position: relative; height:100%; } .swipe-wrap { overflow: hidden; position: relative; height:100%; } .swipe-wrap > section { float:left; 100%; height:100%; position: relative; } .swipe-wrap > section:nth-child(1){ background:#ccc; } .swipe-wrap > section:nth-child(2){ background:pink; } .swipe-wrap > section:nth-child(3){ background:#ddd; }
JS代码:
window.mySwipe = 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) {} });
设置选项
- startSlideInteger(default:0)- 开始滚动的位置
- speedInteger(default:300)- 动画滚动的间隔(秒数)
- autoInteger -开始自动幻灯片(以毫秒为单位幻灯片之间的时间)
- continuousBoolean(default:true)- 创建一个无限的循环(当滑动到所有动画结束时是否循环滑动)
- disableScrollBoolean(default:false)- 当滚动滚动条时是否停止幻灯片滚动
- stopPropagationBoolean(default:false)- 是否停止事件冒泡
- callbackFunction - 幻灯片运行中的回调函数
- transitionEndFunction - 动画运行结束的回调函数
还有一些比较使用的API方法,例如:
- prev():上一页
- next():下一页
- getPos():获取当前页的索引
- getNumSlides():获取所有项的个数
- slide(index, duration):滑动方法
<button onclick="Swipe.prev()">prev</button> <button onclick="Swipe.next()">next</button>
缺点:
貌似没有上下滑动,为了弥补这个缺点,更改了swipe.js 源码 , 实现上下切换 , 参数还是一样设置
/** Swipe 2.0 * * Brad Birdsall * Copyright 2013, MIT License * */ functionSwipe(container, options) { "use strict"; //utilities var noop = function() {}; //simple no operation function var offloadFn = function(fn) { setTimeout(fn || noop, 0) }; //offload a functions execution //check browser capabilities var browser ={ addEventListener: !!window.addEventListener, touch: ('ontouchstart' in window) || window.DocumentTouch && document instanceofDocumentTouch, transitions: (function(temp) { var props = ['transformProperty', 'WebkitTransform', 'MozTransform', 'OTransform', 'msTransform']; for ( var i in props ) if (temp.style[ props[i] ] !== undefined) return true; return false; })(document.createElement('swipe')) }; //quit if no root element if (!container) return; var element = container.children[0]; varslides, slidePos, height; options = options ||{}; var index = parseInt(options.startSlide, 10) || 0; var speed = options.speed || 500; options.continuous = options.continuous ? options.continuous : true; functionsetup() { //cache slides slides =element.children; //create an array to store current positions of each slide slidePos = newArray(slides.length); //determine height of each slide height = container.getBoundingClientRect().height ||container.offsetHeight; element.style.height = ( height) + 'px'; //stack elements var pos =slides.length; while(pos--) { var slide =slides[pos]; slide.style.height = height + 'px'; slide.setAttribute('data-index', pos); if(browser.transitions) { slide.style.top = (pos * -height) + 'px'; move(pos, index > pos ? -height : (index < pos ? height : 0), 0); } } if (!browser.transitions) element.style.top = (index * -height) + 'px'; container.style.visibility = 'visible'; } functionprev() { if (index) slide(index-1); else if (options.continuous) slide(slides.length-1); } functionnext() { if (index < slides.length - 1) slide(index+1); else if (options.continuous) slide(0); } functionslide(to, slideSpeed) { //do nothing if already on requested slide if (index == to) return; if(browser.transitions) { var diff = Math.abs(index-to) - 1; var direction = Math.abs(index-to) / (index-to); //1:right -1:left while (diff--) move((to > index ? to : index) - diff - 1, height * direction, 0); move(index, height * direction, slideSpeed ||speed); move(to, 0, slideSpeed ||speed); } else{ animate(index * -height, to * -height, slideSpeed ||speed); } index =to; offloadFn(options.callback &&options.callback(index, slides[index])); } functionmove(index, dist, speed) { translate(index, dist, speed); slidePos[index] =dist; } functiontranslate(index, dist, speed) { var slide =slides[index]; var style = slide &&slide.style; if (!style) return; style.webkitTransitionDuration =style.MozTransitionDuration =style.msTransitionDuration =style.OTransitionDuration =style.transitionDuration = speed + 'ms'; style.webkitTransform = 'translate(0,' + dist + 'px)' + 'translateZ(0)'; style.msTransform =style.MozTransform =style.OTransform = 'translateY(' + dist + 'px)'; } functionanimate(from, to, speed) { //if not an animation, just reposition if (!speed) { element.style.top = to + 'px'; return; } var start = +newDate; var timer = setInterval(function() { var timeElap = +new Date -start; if (timeElap >speed) { element.style.top = to + 'px'; if(delay) begin(); options.transitionEnd &&options.transitionEnd.call(event, index, slides[index]); clearInterval(timer); return; } element.style.top = (( (to - from) * (Math.floor((timeElap / speed) * 100) / 100) ) + from) + 'px'; }, 4); } //setup auto slideshow var delay = options.auto || 0; varinterval; functionbegin() { interval =setTimeout(next, delay); } functionstop() { delay = 0; clearTimeout(interval); } //setup initial vars var start ={}; var delta ={}; varisScrolling; //setup event capturing var events ={ handleEvent: function(event) { switch(event.type) { case 'touchstart': this.start(event); break; case 'touchmove': this.move(event); break; case 'touchend': offloadFn(this.end(event)); break; case 'webkitTransitionEnd': case 'msTransitionEnd': case 'oTransitionEnd': case 'otransitionend': case 'transitionend': offloadFn(this.transitionEnd(event)); break; case 'resize': offloadFn(setup.call()); break; } if(options.stopPropagation) event.stopPropagation(); }, start: function(event) { var touches = event.touches[0]; //measure start values start ={ //get initial touch coords x: touches.pageX, y: touches.pageY, //store time to determine touch duration time: +newDate }; //used for testing first move event isScrolling =undefined; //reset delta and end measurements delta ={}; //attach touchmove and touchend listeners element.addEventListener('touchmove', this, false); element.addEventListener('touchend', this, false); }, move: function(event) { //ensure swiping with one touch and not pinching if ( event.touches.length > 1 || event.scale && event.scale !== 1) return if(options.disableScroll) event.preventDefault(); var touches = event.touches[0]; //measure change in x and y delta ={ x: touches.pageX -start.x, y: touches.pageY -start.y } //determine if scrolling test has run - one time test if ( typeof isScrolling == 'undefined') { isScrolling = !!( isScrolling || Math.abs(delta.y) <Math.abs(delta.x) ); } //if user is not trying to scroll vertically if (!isScrolling) { //prevent native scrolling event.preventDefault(); //stop slideshow stop(); //increase resistance if first or last slide delta.y =delta.y /( (!index && delta.y > 0 //if first slide and sliding left || index == slides.length - 1 //or if last slide and sliding right && delta.y < 0 //and if sliding at all ) ?( Math.abs(delta.y) / height + 1 ) //determine resistance level : 1 ); //no resistance if false //translate 1:1 translate(index-1, delta.y + slidePos[index-1], 0); translate(index, delta.y + slidePos[index], 0); translate(index+1, delta.y + slidePos[index+1], 0); } }, end: function(event) { //measure duration var duration = +new Date -start.time; //determine if slide attempt triggers next/prev slide var isValidSlide =Number(duration) < 250 //if slide duration is less than 250ms && Math.abs(delta.y) > 20 //and if slide amt is greater than 20px || Math.abs(delta.y) > height/2; // or ifslide amt is greater than half the width //determine if slide attempt is past start and end var isPastBounds = !index && delta.y > 0 //if first slide and slide amt is greater than 0 || index == slides.length - 1 && delta.y < 0; //or if last slide and slide amt is less than 0 //determine direction of swipe (true:right, false:left) var direction = delta.y < 0; //if not scrolling vertically if (!isScrolling) { if (isValidSlide && !isPastBounds) { if(direction) { move(index-1, -height, 0); move(index, slidePos[index]-height, speed); move(index+1, slidePos[index+1]-height, speed); index += 1; } else{ move(index+1, height, 0); move(index, slidePos[index]+height, speed); move(index-1, slidePos[index-1]+height, speed); index += -1; } options.callback &&options.callback(index, slides[index]); } else{ move(index-1, -height, speed); move(index, 0, speed); move(index+1, height, speed); } } //kill touchmove and touchend event listeners until touchstart called again element.removeEventListener('touchmove', events, false) element.removeEventListener('touchend', events, false) }, transitionEnd: function(event) { if (parseInt(event.target.getAttribute('data-index'), 10) ==index) { if(delay) begin(); options.transitionEnd &&options.transitionEnd.call(event, index, slides[index]); } } } //trigger setup setup(); //start auto slideshow if applicable if(delay) begin(); //add event listeners if(browser.addEventListener) { //set touchstart event on element if (browser.touch) element.addEventListener('touchstart', events, false); if(browser.transitions) { element.addEventListener('webkitTransitionEnd', events, false); element.addEventListener('msTransitionEnd', events, false); element.addEventListener('oTransitionEnd', events, false); element.addEventListener('otransitionend', events, false); element.addEventListener('transitionend', events, false); } //set resize event on window window.addEventListener('resize', events, false); } else{ window.onresize = function () { setup() }; //to play nice with old IE } //expose the Swipe API return{ setup: function() { setup(); }, slide: function(to, speed) { slide(to, speed); }, prev: function() { //cancel slideshow stop(); prev(); }, next: function() { stop(); next(); }, getPos: function() { //return current index position returnindex; }, kill: function() { //cancel slideshow stop(); //reset element element.style.width = 'auto'; element.style.top = 0; //reset slides var pos =slides.length; while(pos--) { var slide =slides[pos]; slide.style.width = '100%'; slide.style.top = 0; if (browser.transitions) translate(pos, 0, 0); } //removed event listeners if(browser.addEventListener) { //remove current event listeners element.removeEventListener('touchstart', events, false); element.removeEventListener('webkitTransitionEnd', events, false); element.removeEventListener('msTransitionEnd', events, false); element.removeEventListener('oTransitionEnd', events, false); element.removeEventListener('otransitionend', events, false); element.removeEventListener('transitionend', events, false); window.removeEventListener('resize', events, false); } else{ window.onresize = null; } } } } if ( window.jQuery ||window.Zepto ) { (function($) { $.fn.Swipe = function(params) { return this.each(function() { $(this).data('Swipe', new Swipe($(this)[0], params)); }); } })( window.jQuery ||window.Zepto ) }
http://www.jiawin.com/demo/6589.html