使用需要依赖JQuery,在 js/jquery-3.3.3.min.js 中,本项目主文件只有一个js/SwipeImg.js,下载这两个文件到本地即可。
本项目就是一个例子,可以全部下载运行查看效果。
演示一个简单的例子
html
<div class="imgbox"></div>js
var imgSrc = ["img/1.jpg", "img/2.jpg", "img/3.jpg"];
new SwipeImg(".imgbox", imgSrc).show(1500);className:String类型 绑定html中的一个类。resource:Array类型 图片链接数组,可以是网络链接 或者 颜色字符串数组- [可选]
options:Object
{
//type 可以传3种类型,默认是图片资源SwipeImg.TYPE.image,SwipeImg.TYPE.color 是颜色资源, SwipeImg.TYPE.element 是元素资源
type:SwipeImg.TYPE.color,
//button 是切换按钮,传入true显示默认样式按钮,或者传入['a','b']数组来自定义按钮的class,a表示前切换按钮class,b后切换按钮class
button:true,
//ms : 动画持续时间,单位毫秒
ms:1000,
//fn : 动画过渡效果,'ease','linear'等
fn: 'linear',
}
time:Number类型 切换图片的时间间隔delay:Number类型 开始轮播的延迟时间
例子演示结束
var imgSrc = ["img/1.jpg", "img/2.jpg", "img/3.jpg"];
new SwipeImg(".imgbox", imgSrc)
.setImgBoxCss({ //设置图片容器css,也就是.imgbox
width: "50%",
height: "300px",
"margin-top": "200px",
"perspective-origin": "center",
"perspective": "1500px",
position: "relative",
bottom:"100px",
}).setImgCss({ //设置图片css
})
.show(1500);css:Object和Jquery设置css相同
css:Object和Jquery设置css相同
var imgSrc = ["img/1.jpg", "img/2.jpg", "img/3.jpg"];
var transform = [{
transform: "translate3d(-100%, 0%,-500px) rotateY(-90deg)"
}, {
transform: "translate3d(0%, 0%,0px) rotateY(0deg)"
}, {
transform: "translate3d(100%, 0%,-500px) rotateY(90deg)"
}];
new SwipeImg(".imgbox", imgSrc)
.setTransform(transform)
.show(1500);transform:Array能且只能是3个有css对象的数组,transform[0]:图片消失的位置,transform[1]:图片显示时的位置,transform[2]:图片准备出现时的位置,图片会根据这3个位置来循环切换。
//随机滑动样式
var randomSwipeImg = (function () {
return function () {
var transform = [{
transform: `translate(${randomMinus()}100%, ${randomMinus()}${randomStr()}%)`
}, {
transform: `translate(0%, 0%) scale(1)`
}, {
transform: `translate(${randomMinus()}100%, ${randomMinus()}${randomStr()}%)`
}];
this.setTransform(transform);
this.loadTransform(); //show方法调用后,不会自动加载transform,需要手动调用loadTransform(),才能加载到浏览器中。
};
})();
new SwipeImg(".imgbox", imgSrc)
.setSwipeListener(randomSwipeImg) //切换图片时的监听器
.show(1500);设置切换图片时的监听器,每次切换图片前,都会调用listener,通常用来动态切换transtion,实现多种切换效果
listener:Function 监听器
出现网络图片加载卡顿时,可以设置预加载数,来减少卡顿,只有时图片资源时,该设置才有效。
count: Number ,预加载的数量