jQuery的图片轮播插件PgwSlideshow使用详解

<link href="~/Content/plugins/pgwSlideshow/pgwslideshow.min.css" type="text/css" rel="stylesheet" />
<script src="/UploadFiles/2021-04-02/jquery-2.1.4.min.js">

引用默认样式pgwslideshow.min.css的效果

引用浅色系样式pgwslideshow_light.min.css的效果

1.1 定义Html元素结构
pgwslideshow采用ul元素，ul元素中的每一个li标签标识一张轮播图片


<!--定义ul其class指定为"pgwSlideshow"-->
<ul class="pgwSlideshow">
<!--src：标识轮播图片的路径-->
<!--alt：标识轮播图片的标题-->
<!--data-description：标识轮播图片的数据描述，显示在标题的下方-->
<!--data-large-src：标识轮播图片的上方大图的路径，如不设置，默认采用src的图片路径-->
<li><img src="/UploadFiles/2021-04-02/san-francisco.jpg">


1.2 插件的使用
pgwslideshow的使用非常简单，只需通过ul元素调用pgwSlideshow()方法即可。


$(document).ready(function() {
$('.pgwSlideshow').pgwSlideshow();
});


方法调用时，我们还可以根据需要做一些配置


var option = {
mainClassName: 'pgwSlideshow', //用你的自定义css样式来展现轮播图
transitionEffect: 'sliding', //轮播图切换时动画效果，有两个选项sliding（滑动效果）、fading（渐隐效果）
autoSlide: false, //是否允许轮播图自动按照时间间隔轮播
beforeSlide: false, //function类型属性，在轮播图每次切换前的回调函数。如"function(id) { console.log('切换前，当前id' + id); }"
afterSlide: false, //function类型属性，在轮播图每次切换后的回调函数。如"function(id) { console.log('切换后，当前id' + id); }"
displayList: true, //是否以列表的形式显示缩略图
displayControls: true, //是否显示向前，向后翻页的按钮。
touchControls: true, //是否支持移动设备触摸翻页操作
maxHeight: null, //设置轮播插件的最大高度，直接写数值即可，不需要带px单位
transitionDuration: 500, //图片自动轮播时，图片切换的时间，单位毫秒
intervalDuration: 3000 //显示下一张图片之前的间隔时间单位毫秒，该参数需要autoSlide为true
};
$('.pgwSlideshow').pgwSlideshow(option);


1.3 一些常用的js方法 


var pgwSlideshow = $('.pgwSlideshow').pgwSlideshow(); //获取轮播插件对象
pgwSlideshow.startSlide(); //控制轮播插件开始轮播
pgwSlideshow.stopSlide(); //控制轮播插件停止轮播
pgwSlideshow.getCurrentSlide(); //获取当前轮播图片的序号 
pgwSlideshow.getSlideCount(); //获取当前轮播插件包含的图片个数 
pgwSlideshow.displaySlide(3); //通过参数中的数值来显示指定序号的轮播图图片
pgwSlideshow.nextSlide(); //显示下一幅图片
pgwSlideshow.previousSlide(); //显示前一幅图片
pgwSlideshow.destroy(); //销毁轮播图对象。可通过可选的参数控制，如果传入参数true，那么容器只是被隐藏起来
pgwSlideshow.reload({ //使用新的配置参数来重新加载轮播图插件
transitionEffect: 'fading', 
adaptiveDuration: 4000 
});


1.4 加载服务端数据
加载服务端数据同样很简单，只需要根据服务端返回的数据，动态构造li标签，然后添加的ul元素中，接着调用pgwSlideshow()就行了。


<ul class="pgwSlideshow" id="pictureBox"></ul> 
$(function () {
var pictures = JSON.parse($("#anchorPictures").val()); //此处一般用ajax接受服务端返回数据
var html = ""
$.each(pictures, function (i, item) {
html += "<li><img src='" + item.AttachmentUrl + "' data-large-src='" + item.AttachmentUrl + "' alt='" + item.AttachmentName + "' data-description='" + item.AttachmentName + "'></li>";
});
$("#pictureBox").html(html);
$('.pgwSlideshow').pgwSlideshow();
});


以上所述是小编给大家介绍的jQuery的图片轮播插件PgwSlideshow使用详解，希望对大家有所帮助，如果大家有任何疑问请给我留言，小编会及时回复大家的。在此也非常感谢大家对网站的支持！