jQuery封装的轮播图组件（按需加载）

小仙儿

2020-03-01

效果图

slider.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>slider</title>
    <link rel="stylesheet" href="../css/base.css">
    <link rel="stylesheet" href="../css/slider.css">
</head>
<body>
    <div class="slider">
        <div class="slider-img slide-slide">
            <a href="#" class="slider-img-item"><img src="../img/focus-slider/loading.gif" data-src="../img/focus-slider/1.png" class="slider-pic"></a>
            <a href="#" class="slider-img-item"><img src="../img/focus-slider/loading.gif" data-src="../img/focus-slider/2.png" class="slider-pic"></a>
            <a href="#" class="slider-img-item"><img src="../img/focus-slider/loading.gif" data-src="../img/focus-slider/3.png" class="slider-pic"></a>
            <a href="#" class="slider-img-item"><img src="../img/focus-slider/loading.gif" data-src="../img/focus-slider/4.png" class="slider-pic"></a>
        </div>
        <ol class="slider-tip">
            <li class="slider-tip-item text-hidden fl">1</li>
            <li class="slider-tip-item text-hidden fl">2</li>
            <li class="slider-tip-item text-hidden fl">3</li>
            <li class="slider-tip-item text-hidden fl">4</li>
        </ol>
        <a href="javascript:;" class="slider-arrow slider-arrow-left">&lt;</a>
        <a href="javascript:;" class="slider-arrow slider-arrow-right">&gt;</a>
    </div>

    <script src="../js/jquery.js"></script>
    <script src="../js/transition.js"></script>
    <script src="../js/showhide.js"></script>
    <script src="../js/move.js"></script><!-- 滑动模块 -->
    <script src="../js/slider.js"></script>
    <script>
        var slider=$(".slider");

        //设置全局变量的属性
        slider.loadedPics={};//用来保存已经加载过的图片
        slider.loadedPicsNum=0;//已经加载的图片数量
        slider.totalPicsNum=slider.find(".slider-pic").length;//总共需要加载的图片数量

        //接收到开始显示图片的消息
        slider.on("slider-show",slider.loadFn=function(e,i,elem){
            console.log("开始显示图片");
            if(slider.loadedPics[i] !== "loaded"){
                console.log("准备加载图片"+i);
                slider.trigger("slider-loadPic",[i,elem]);                
            }        
        });

        //绑定开始加载图片的自定义事件
        slider.on("slider-loadPic",function(e,i,elem){
            //按需加载
            var img=$(elem).find(".slider-pic");//这个img是jQuery对象

            loadImg(img.data("src"),function(url){        
                img.attr("src",url);

                slider.loadedPics[i]="loaded";
                slider.loadedPicsNum++;
                console.log(i+"加载完成");

                if(slider.loadedPicsNum===slider.totalPicsNum){
                    // 全部加载完毕
                    slider.trigger("slider-PicLoaded");
                }
            },function(url){
                img.attr("src","../img/focus-slider/placeholder.png");
                console.log(i+"加载失败");
            })
        })

        //绑定全部加载完毕的自定义事件
        slider.on("slider-PicLoaded",function(e){
            console.log("所有图片加载完成");
            //清除事件
            slider.off("slider-show",slider.loadFn);
        })

        function loadImg(url,loadedCall,errorCall){
            var img=new Image();//创建一个<img>标签，这个是原生的js对象
            //图片加载失败时执行回调
            img.onerror=function(){
                //图片加载完成后执行回调
                if(typeof errorCall==="function") errorCall(url);
            }        
            //图片加载完成后执行回调
            img.onload=function(){                
                if(typeof loadedCall==="function") loadedCall(url);
            }                    
            //人为延迟模拟线上加载图片
            setTimeout(function(){
                img.src=url;//原生js对象可以使用原生js方法
            },500);
        }

        //传入自定义参数
        slider.Slider({
            css3:true,
            js:true,
            animation:"slide",
            activeIdx:0,//从哪张开始轮播
            interval:1000//xx毫秒的速度轮播        
        });

    </script>
</body>
</html>

base.css https://www.cnblogs.com/chenyingying0/p/12363689.html
slider.css

/*showhide*/
    .fadeOut{
        opacity: 0;
        visibility: hidden;
    }
    .slideUpDownCollapse{
        height:0 !important;/*避免因为优先级不够而无法生效*/
        padding-top:0 !important;
        padding-bottom:0 !important;
    }
    .slideLeftRightCollapse{
        width:0 !important;/*避免因为优先级不够而无法生效*/
        padding-left:0 !important;
        padding-right:0 !important;
    }
    .fl{
        float:left;
    }
    .fr{
        float:right;
    }
    /*提取出过渡样式，可公用*/
    .transition{
        -webkit-transition:all .5s;
        -moz-transition:all .5s;
        -ms-transition:all .5s;
        -o-transition:all .5s;
        transition:all .5s;
    }
    /*文字隐藏*/
    .text-hidden{
        text-indent:-9999px;
        overflow:hidden;
    }
    .slider{
        width:728px;
        height:504px;
        position: relative;
        overflow:hidden;
    }
    .slider-img{
        width:100%;
        height:100%;
        position: relative;
    }
    /*fade方式*/
    .slide-fade .slider-img-item{
        width:100%;
        height:100%;
        position: absolute;
        top:0;
        left:0;    
        display: none;    
    }
    /*slide方式*/
    .slide-slide .slider-img-item{
        width:100%;
        height:100%;
        position: absolute;
        top:0;
        left:100%;        
    }
    .slider-tip{
        position: absolute;
        height:12px;
        width:78px;
        bottom:24px;
        left:50%;
        margin-left:-36px;
    }
    .slider-tip-item{        
        width:8px;
        height:8px;
        border:2px solid #e4e8eb;
        background-color: #313a43;
        margin-right:10px;
        border-radius:50%;
    }
    .slider-tip-item-active{
        background-color:#e4e8eb;
        border:2px solid #313a43;
    }
    .slider-tip-item:last-child{
        margin-right:0;
    }
    .slider-arrow{
        display: none;
        position: absolute;
        width:30px;
        height:40px;
        line-height:40px;
        top:50%;
        margin-top:-20px;
        background-color:rgba(0,0,0,.5);
        color:#e4e8eb;
        text-align: center;
        font-size:20px;
        font-family:simsum;
    }
    .slider-arrow-left{
        left:0;
    }
    .slider-arrow-right{
        right:0;
    }

transition.js https://www.cnblogs.com/chenyingying0/p/12363649.html
showhide.js https://www.cnblogs.com/chenyingying0/p/12363707.html
move.js https://www.cnblogs.com/chenyingying0/p/12380632.html
slider.js

(function($){
    ‘use strict‘;//使用严格模式

    //构造函数形式
    function Slider(elem,options){
        //保存到this中才能公用
        this.elem=elem;
        this.picBox=this.elem.find(".slider-img");
        this.options=options;

        this.pics=this.elem.find(".slider-img-item");
        this.tips=this.elem.find(".slider-tip-item");
        this.arrows=this.elem.find(".slider-arrow");

        this.size=this.pics.length;
        this.curIdx=this._getIdx(this.options.activeIdx);
        
        this._init();//初始化，下划线开头通常约定为仅供内部使用
    }
    //默认参数
    Slider.defaults={
        css3:false,
        js:false,
        animation:"fade",
        activeIdx:0,//从哪张开始轮播
        interval:0//默认没有自动轮播
    };
    //初始化
    Slider.prototype._init=function(){
        var self=this;

        //初始化时触发事件，传入参数为当前索引，以及当前的图片
        this.elem.trigger("slider-show",[this.curIdx,this.pics[this.curIdx]]);

        //init show 显示指定圆点
        this.tips.removeClass("slider-tip-item-active");
        this.tips.eq(this.curIdx).addClass("slider-tip-item-active");

        //指定动画方式 to
        if(this.options.animation==="slide"){
            //slide
            this.picBox.addClass("slide-slide");
            this.pics.eq(this.curIdx).css("left",0);            

            //slide 模块  send message
            this.pics.on("move moved",function(e){
                var index=self.pics.index(this);//获取当前触发事件的幻灯片的索引

                if(e.type==="move"){
                    //move 开始运动
                    if(self.curIdx===index){
                        //这张开始隐藏
                        self.elem.trigger("slider-hide",[index,this]);
                    }else{
                        //这张开始显示
                        self.elem.trigger("slider-show",[index,this]);
                    }
                }else{
                    //moved 结束运动
                    if(self.curIdx===index){//此时已经操作了self.curIdx=index; 因此情况需要相反
                        //这张开始隐藏
                        self.elem.trigger("slider-shown",[index,this]);
                    }else{
                        //这张开始显示
                        self.elem.trigger("slider-hidden",[index,this]);
                    }
                }
            })

            //move init控制幻灯片的显示隐藏
            this.pics.move(this.options);
            this.to=this._slide;

            this.picWidth=this.pics.eq(0).width();
            this.transitionCls=this.pics.eq(0).hasClass("transition")?"transition":"";
        
        }else{    
            //fade        
            this.picBox.addClass("slide-fade");
            //显示指定图片
            this.pics.eq(this.curIdx).show();

            //fade 模块 发送消息（调用showhide模块的是幻灯片元素，因此发送接收消息的也是幻灯片元素）
            this.pics.on("show shown hide hidden",function(e){
                self.pics.trigger("slider-"+e.type,[self.pics.index(this),this]);
                //返回的数组包含当前图片的索引+触发事件的对象
            })

            //showHide init控制幻灯片的滑动
            this.pics.showHide(this.options);
            this.to=this._fade;
        }

        //鼠标移入显示左右箭头
        this.elem.hover(function(){
            self.arrows.show();
        },function(){
            self.arrows.hide();
        }).on("click",".slider-arrow-left",function(){//左箭头，图片left为正
            //事件代理
            self.to(self._getIdx(self.curIdx-1),1);//第二个参数代表滑动时的方向
        }).on("click",".slider-arrow-right",function(){//右箭头，图片left为负
            self.to(self._getIdx(self.curIdx+1),-1);
        }).on("click",".slider-tip-item",function(){
            self.to(self._getIdx(self.tips.index(this)));
            //self.tips.index(this)是当前点击的圆点的索引
        });

        //auto 
        if(this.options.interval && !isNaN(Number(this.options.interval))){
            //鼠标移入时暂停自动切换
            this.elem.hover($.proxy(this.pause,this),$.proxy(this.auto,this));

            this.auto();
        }

    };
    //获取合理的索引
    Slider.prototype._getIdx=function(index){
        if(isNaN(Number(index))) return 0;
        if(Number(index)<0) return this.size-1;
        if(Number(index)>this.size-1) return 0;
        return index;
    }
    //激活小圆点
    Slider.prototype._activateTips=function(index){
        this.tips.eq(this.curIdx).removeClass("slider-tip-item-active");
        this.tips.eq(index).addClass("slider-tip-item-active");
    }
    //淡入淡出方式
    Slider.prototype._fade=function(index){
        if(this.curIdx===index) return;//点击当前索引不再切换

        this.pics.eq(this.curIdx).showHide("hide");
        this.pics.eq(index).showHide("show");

        this._activateTips(index);

        this.curIdx=index;
        
    }
    //滑动方式
    Slider.prototype._slide=function(index,direction){
        var self=this;
        if(this.curIdx===index) return;//点击当前索引不再切换

        //确定滑入滑出方向
        if(!direction){
            //click tips
            if(this.curIdx>index){
                direction=1;//向右，left为正
            }else if(this.curIdx<index){
                direction=-1;//向左，left为负
            }
        }

        //设置指定滑入幻灯片的初始位置
        this.pics.eq(index).removeClass(this.transitionCls).css("left",-1*direction*this.picWidth);
        
        //当前幻灯片滑出可视区域，指定幻灯片滑入可视区域
        setTimeout(function(){
            self.pics.eq(self.curIdx).move("x",direction*self.picWidth);//当前的滑出可视区
            self.pics.eq(index).addClass(self.transitionCls).move("x",0);//指定图片滑入，如果是css3，加入刚才被移除的transition
            self.curIdx=index;
        },20)
        
        //激活tips
        this._activateTips(index);    
        
    }
    //自动
    Slider.prototype.auto=function(){
        var self=this;
        this.timer=setInterval(function(){
            self.to(self._getIdx(self.curIdx+1),-1);
        },self.options.interval);        
    }
    //停止
    Slider.prototype.pause=function(){
        clearInterval(this.timer);    
    }

    //插件形式
    $.fn.extend({
        Slider:function(opt){
            //return this可以返回对象，方便连写
            return this.each(function(){
                var ui=$(this);
                var slider=ui.data("slider");
                //opt是参数对象
                var options=$.extend({},Slider.defaults,ui.data(),typeof opt==="object"&&opt);
                
                //单例：一个DOM元素对应一个实例，如果已经存在则不需要反复实例化
                if(!slider){
                    slider=new Slider(ui,options);
                    ui.data("slider",slider);
                }
                
                //opt是show或者hide
                if(typeof slider[opt]==="function"){
                    Slider[opt]();
                }
            });
        }
    });

})(jQuery);
//为了防止$符发生冲突，将jQuery作为参数传入，则$符作为内部变量，不会发生冲突

注意：使用trigger的自定义事件时，触发事件的元素，和绑定事件的元素，必须相同。

轮播 jquery slider