我平时用到图片切换的效果较多,所以自己封装了个插件。支持淡入淡出、水平方向切换、垂直方向切换、卡片样式切换
使用方法
引用相应js文件到页面,并对元素调用相应方法
<script src="jquery.min.js"></script>
<script src="sliderPic.js"></script>
<script type="text/javascript" charset="utf-8">
$(function() {
var bannerSlider = $('.banner').sliderPic({
piclist: '.piclist',
btnlist: '.btnbox',
mode: 'slidX',
autoplay: 5000,
speed: 600,
loop: true
});
$('.next-btn').on('click', function() {
bannerSlider.moveNext();
});
});
</script>
html结构
<div class="banner">
<ul class="piclist">
<li style="background-image:url(1.jpg)"></li>
<li style="background-image:url(2.jpg)"></li>
</ul>
<div class="btnbox"></div>
</div>
<a class="next-btn"></a>
参数设置
配置参数
| 参数名 | 类型 | 默认值 | 可选值 | 说明 |
|---|---|---|---|---|
| piclist | String | .piclist | 自定义 | 图片列表 选择器 |
| btnlist | String | .btnlist | 自定义 | 索引容器 选择器 |
| mode | String | fade | fade | slidX | slidY | turnX | turnY | 动画的播放方式(淡入淡出 | 水平滚动 | 垂直滚动 | 水平转轮 | 垂直转轮) |
| speed | Number | 600 | 自定义 | 滚动速度。每次切换时持续的时间 |
| autoplay | Number | 0 | 自定义 | 自动播放频率。0表示不自动播放 |
| loop | Boolean | false | true | false | 无缝循环。当播放方式为fade时,此参数无用 |
| viewNum | Number | 1 | 自定义 | 可视区域显示的滑块数。当播放方式为fade时,此参数无用 |
| trunMain | Number | 2 | 自定义 | 突出的转轮所处位置(从1开始计数。该参数只有转轮播放有效) |
| turnOpacityRatio | Number | 0.2 | 自定义 | 转轮透明比例(该参数只有转轮播放有效) |
| turnScaleRatio | Number | 0.2 | 自定义 | 转轮缩放比例(该参数只有转轮播放有效) |
| startSwitch | Function | function(index){} | 开始准备切换图片的回调方法(回调参数index为结束切换后当前图片的index值) | |
| endSwitch | Function | function(index){} | 结束切换后的回调方法(回调参数index为当前图片的index值) | |
| resize | Function | function(view){} | 滑块容器尺寸变化时的回调方法(回调参数view为当前可视区显示滑块数) |
基础属性和方法
| 参数名 | 类型 | 默认值 | 示例 | 说明 |
|---|---|---|---|---|
| movePrev | Function | sliderlPic.movePrev() | 滚动到上一张图片 | |
| moveNext | Function | sliderlPic.moveNext() | 滚动到下一张图片 | |
| moveTo | Function | sliderlPic.moveTo(2) | 滚动到指定索引的图片 | |
| pause | Function | sliderlPic.pause() | 如果图片设置了自动滚动,调用此方法可以暂停滚动 | |
| proceed | Function | sliderlPic.proceed() | 与pause()配套使用,调用此方法将继续滚动 | |
| update | Function | sliderlPic.update({viewNum: 2}) | 更新组件 |