jQuery带缩略图响应式轮播图插件PgwSlideshow

所属分类:媒体-幻灯片和轮播图

 44540  384  查看评论 (17)
分享到微信朋友圈
X
jQuery带缩略图响应式轮播图插件PgwSlideshow ie兼容10

简要教程

PgwSlideshow是一款非常实用的响应式、支持触摸屏的jQuery轮播图插件。该轮播图插件带有缩略图预览效果,可以根据容器的大小自适应图片的宽度。你也可以自定义轮播图的高度,图片宽度会根据高度等比例匹配。该轮播图插件的特点有:

  • 响应式设计

  • 支持桌面和移动手机设备

  • 轻量级,压缩后只有4kb

  • 可以通过CSS来自定义轮播图的样式

使用方法

该轮播图插件依赖于jQuery(1.0以上版本)或Zepto(1.0以上版本)。使用前要移入这些依赖文件。

<link rel="stylesheet" href="/path/to/pgwslideshow.css">
<script src="jquery/1.11.0/jquery.min.js"></script>
<script src="/path/to/pgwslideshow.js"></script>

HTML结构

该轮播图插件的基本HTML结构使用的是无序列表<ul>。你可以添加多个<li>元素,每一个<li>元素中包含一张用于轮播的图片。

<ul class="pgwSlideshow">
    <li><img src="img/1.jpg" alt="..." data-description="..."></li>
    <li><img src="img/thumb.jpg" alt="" data-large-src="img/big-img.jpg"></li>
    <li>
        <a href="#" target="_blank">
            <img src="img/3.jpg" alt="...">
        </a>
    </li>
    ......
</ul>
  • alt:这个属性定义图片的标题,它会在图片显示的时候作为标题显示。

  • data-description:该属性会在图片标题下方添加一行新的文本,用于额外的描述信息。

  • data-large-src:如果你希望缩略图使用小尺寸的图片,显示的是大尺寸的图片,就可以使用data-large-src属性来指定大尺寸图片的URL。

另外,如果你希望某张图片链接到特定的URL,可以使用<a>标签来包裹图片,每张图片都可以单独设置它的对应链接地址。

调用插件

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

配置参数

下面是该轮播图插件的一些可用的参数。

参数类型默认值描述
mainClassNameString'pgwSlideshow'该参数会覆盖轮播图默认的CSS class名称。
transitionEffectString'sliding'有两个可用的过渡效果:"sliding" 和 "fading"
autoSlideBooleanfalse是否允许轮播图自动轮播
beforeSlideFunctionfalse在轮播图每次切换时的回调函数。eg:"function(id) { console.log('Before sliding - The current slide is ' + id); }"
afterSlideFunctionfalse在轮播图每次切换之后的回调函数。eg:"function(id) { console.log('After sliding - The current slide is ' + id); }"
displayListBooleantrue是否以列表的形式显示缩略图
displayControlsBooleantrue是否显示前后箭头导航按钮
touchControlsBooleantrue是否绑定移动触摸事件
maxHeightIntegernull为轮播图设置固定的高度。不用带"px"单位
adaptiveDurationInteger200This duration is the period in milliseconds, during the adjustment of the previous option runs (if it is activated).
transitionDurationInteger500图片切换的时间,单位毫秒
intervalDurationInteger3000显示下一张图片之前的间隔时间,该参数需要autoSlide为true

方法

下面是该轮播图插件的一些可用方法。

要使用这些方法,必须在轮播图插件初始化时将它保存为一个对象变量。

var pgwSlideshow = $('.pgwSlideshow').pgwSlideshow();
  • startSlide :轮播图开始播放。

pgwSlideshow.startSlide();
  • stopSlide :停止轮播图的播放。

pgwSlideshow.stopSlide();
  • getCurrentSlide :返回当前轮播图片的序号。

pgwSlideshow.getCurrentSlide();
  • getSlideCount :返回轮播图中图片的总数。

pgwSlideshow.getSlideCount();
  • displaySlide :通过参数中的数值来显示指定序号的轮播图图片。

pgwSlideshow.displaySlide(3);
  • nextSlide :显示下一幅图片。

pgwSlideshow.nextSlide();
  • previousSlide :显示前一幅图片。

pgwSlideshow.previousSlide();
  • destroy :销毁轮播图对象。如果传入参数true,那么容器将只是被隐藏起来。

pgwSlideshow.destroy();
  • reload :使用新的配置参数来重新加载轮播图插件。

pgwSlideshow.reload({
    transitionEffect : 'fading',
    adaptiveDuration : 4000
});


相关插件-幻灯片和轮播图

原声 JS + Jquery + 面向对象轮播图

几个效果的轮播图,最后组成个组件效果,可供学习
  幻灯片和轮播图
 43788  392

移动端web端图片轮播

移动端web端图片轮播插件,可左右滑动切换,自动切换
  幻灯片和轮播图
 70119  438

全屏无缝滚动加透明遮罩效果

全屏滚动JS 带有遮罩效果
  幻灯片和轮播图
 36253  414

jQuery轮播插件(原创轮播)

代码注释全,方便大家自行修改的轮播插件
  幻灯片和轮播图
 41868  366

讨论这个项目(17)回答他人问题或分享插件使用方法奖励jQ币 评论用户自律公约

    Rock?石头 0
    2021/1/29 18:16:06
    一个页面。需要使用多个插件。但参数不同的情况下。应该怎么做。知道的说下。 回复
    Rock?石头 0
    2021/1/29 17:39:05
    很好的插件。但是还可以升级下。比如。缩略图是左右侧位置显示,比如缩略图并不是图片。可以替换成文字。 回复
    许昌 0
    2019/9/7 12:26:37
    可以插入视频吗
        灭霸媳妇0
        2019/9/7 13:42:53
        可以,将里面的img标签改为你的视内容就行了。
    回复
    空想家_shineY 0
    2019/6/6 9:53:25
    为什么我的css样式不起作用,有相同问题吗 回复
    半圈不直会旋转的爱~ 0
    2018/5/6 19:54:29
    如何设置轮播图的固定宽高呢??
        Young0
        2019/6/26 10:48:39
        同问
    回复
    千卷尺 0
    2018/1/17 16:59:35

    图片并没有居中哦! 

        千卷尺0
        2018/1/18 9:00:49

        唉,有居中的,需要全局清padding + margin, 设置下,是自己大意了。

    回复
    gaoying666 0
    2018/1/15 18:18:14

    谁能告诉我- -  图片切换时候图片闪动放大的bug怎么修

    回复
    蓝色 0
    2017/7/27 14:41:21
    roger_wah 0
    2017/3/3 18:27:54

    如何在调用缩略图的左右箭头

    回复
    Mariosss 0
    2017/1/3 10:01:48
😃
  • 😀
  • 😉
  • 😥
  • 😵
  • 😫
  • 😘
  • 😡
  • 👍
  • 🌹
  • 👏
  • 🍺
  • 🍉
  • 🌙
  • 💖
  • 💔
😃
  • 😀
  • 😉
  • 😥
  • 😵
  • 😫
  • 😘
  • 😡
  • 👍
  • 🌹
  • 👏
  • 🍺
  • 🍉
  • 🌙
  • 💖
  • 💔
取消回复