Sangar Slider是一款功能非常强大的支持触摸屏的响应式jQuery轮播图插件。该轮播图插件具有图片响应式和支持移动触摸屏等特点,可用于作为jQuery插件或WordPress插件使用。该轮播图的特点有:
- 图片响应式和支持触摸屏设备
- 可制作全屏宽度轮播图
- 可以用于制作内容幻灯片
- 多种可用的轮播图导航方式:圆点按钮,文本和缩略图
- 可通过Javascript API来控制轮播图的导航
使用方法
该轮播图插件需要以下的外部依赖文件:
- jQuery
- jQuery migrate
- touchSwipe
- imagesloaded
使用这个轮播图插件要引入sangarSlider.css、sangar-skin-default.css和jquery.sangarSlider.js文件,以及上面提到的外部依赖文件。
<link rel="stylesheet" href="css/sangarSlider.css" type="text/css"> <link rel="stylesheet" href="css/sangar-skin-default.css" type="text/css"> <script type="text/javascript" src="js/jquery.js"></script> <script type="text/javascript" src="js/jquery-migrate.min.js"></script> <script type="text/javascript" src="js/jquery.touchSwipe.min.js"></script> <script type="text/javascript" src="js/imagesloaded.min.js"></script> <script type="text/javascript" src="js/jquery.sangarSlider.js"></script>
HTML结构
该轮播图的基本HTML结构如下:
<div class='sangar-slideshow-container' id='sangar-example'> <div class='sangar-content-wrapper' style='display:none;'> <div class='sangar-content'> <img src='images/slide-1.jpg' /> <a href='http://www.htmleaf.com' target="_blank"></a> </div> <div class='sangar-content'> <img src='images/slide-2.jpg' /> <a href='http://www.htmleaf.com'></a> </div> <div class='sangar-content'> <img src='images/slide-3.jpg' /> </div> <div class='sangar-content'> <img src='images/slide-4.jpg' /> </div> <div class='sangar-content'> <img src='images/slide-5.jpg' /> </div> </div> </div>
初始化插件
在页面加载完毕之后,通过下面的方法来初始化该轮播图插件。
jQuery(document).ready(function($) { $('#sangar-example').sangarSlider(); })
配置参数
下面是该轮播图插件的默认配置参数:
animation : 'horizontal-slide', animationSpeed : 600, continousSliding : true, showAllSlide : false, timer : false, advanceSpeed : 3000, pauseOnHover : true, startClockOnMouseOut : true, startClockOnMouseOutAfter : 800, directionalNav : 'autohide', directionalNavShowOpacity : '0.9' directionalNavHideOpacity : '0.1', directionalNavNextClass : 'exNext', directionalNavPrevClass : 'exPrev', pagination : 'bullet', paginationContent : ["Lorem Ipsum", "Dolor Sit", "Consectetur", "Do Eiusmod", "Magna Aliqua"], paginationContentType : 'text', paginationContentWidth : 120, paginationImageHeight : 90, paginationContentFullWidth : false, paginationExternalClass : 'exPagination', skinClass : 'sangar-skin-default', width : 650, height : 400, scaleSlide : false, scaleImage : true, fixedHeight : true, background: "#222222", imageVerticalAlign : 'middle', jsOnly : false
名称 | 可用值 | 描述 |
animation | horizontal-slide, vertical-slide, fade | 轮播图的动画方式 |
animationSpeed | [number] | 轮播图动画的速度 |
continousSliding | true, false | 控制轮播图不回滚 |
showAllSlide | true, false | 显示所有的前一张和下一张图片 |
timer | true, false | 使用timer来自动播放轮播图 |
advanceSpeed | [number] | 当timer可用时,该参数指定自动播放动画的过渡时间 |
pauseOnHover | true, false | 是否在鼠标滑过时暂停自动播放 |
startClockOnMouseOut | true, false | 是否在鼠标移出时开始计时 |
startClockOnMouseOutAfter | [number] | 在鼠标移出后多长时间重新开始timer计时 |
directionalNav | autohide, show, none | 定向导航 |
directionalNavShowOpacity | [float from 0 to 1] | |
directionalNavHideOpacity | [float from 0 to 1] | |
directionalNavNextClass | [class name] | next导航的class名称 |
directionalNavPrevClass | [class name] | prev导航的class名称 |
pagination | bullet, content, none | 轮播图的导航类型 |
paginationContent | [array string] | 可以是文本,图片或其它内容 |
paginationContentType | text, image | |
paginationContentWidth | [number] | 轮播图导航内容的宽度,单位像素 |
paginationImageHeight | [number] | 图片导航的高度 |
paginationContentFullWidth | true, false | 是否将轮播图的宽度设置为和容器宽度相等 |
paginationExternalClass | [class name] | 如果你使用自己的列表来制作轮播图,用该参数指定class名称 |
skinClass | [skin name] | |
width | [number] | 轮播图的宽度 |
height | [number] | 轮播图的高度 |
scaleSlide | true, false | 是否将轮播图缩放为容器的尺寸 |
scaleImage | true, false | 是否将图片是否到轮播图的尺寸 |
fixedHeight | true, false | 是否在缩放时高度固定 |
background | [color code] | 容器的背景颜色,不设置将是透明背景 |
imageVerticalAlign | top, middle, bottom | |
jsOnly | true, false | 只使用jQuery,不使用CSS3 |