1 /*** 2 ****@link:图片预加载(懒加载)jquery插件版 3 ****@author:linfusheng(改写网摘) 4 ****@time:2013-04-16 5 ****@调用方法:html格式为"<img height="300" width="960" src="" data-original="1.jpg" />"; 6 <script type="text/javascript"> 7 $(document).ready(function() { 8 //1、淡入显示效果 9 $("img").lazyload({ 10 effect: "fadeIn", 11 }); 12 //2、图片没有看到之前先load 200像素 13 $("img").lazyload({ 14 threshold : 200 15 }); 16 //3、通过设置占位符图片和自定事件来触发加载图片事件 17 $("img").lazyload({ 18 placeholder: "img/grey.gif", event: "click" 19 }); 20 //3、通过设置占位符图片和自定事件来触发加载图片事件 21 $("img").lazyload({ 22 placeholder: "img/grey.gif", event: "click" 23 }); 24 //4、页面加载完成后再加载. 页面加载完成 5 秒后, 指定区域内的图片会自动进行加载 25 $(function() { 26 $("img:below-the-fold").lazyload({ 27 placeholder: "img/grey.gif", 28 event: "sporty" 29 }); 30 }); 31 $(window).bind("load", function() { 32 var timeout = setTimeout(function() { 33 $("img").trigger("sporty") }, 5000); 34 }); 35 //5、某个容器内实现图片加载 36 $("img.lazy").lazyload({ 37 container: $("#container") 38 }); 39 });//以上列出了5种常用方法,根据自己的需求选择 40 </script> 41 ***/ 42 (function($, window) { 43 var $window = $(window); 44 45 $.fn.lazyload = function(options) { 46 var elements = this; 47 var $container; 48 var settings = { 49 threshold : 0, 50 failure_limit : 0, 51 event : "scroll", 52 effect : "show", 53 container : window, 54 data_attribute : "original", 55 skip_invisible : true, 56 appear : null, 57 load : null 58 }; 59 60 function update() { 61 var counter = 0; 62 63 elements.each(function() { 64 var $this = $(this); 65 if (settings.skip_invisible && !$this.is(":visible")) { 66 return; 67 } 68 if ($.abovethetop(this, settings) || 69 $.leftofbegin(this, settings)) { 70 } else if (!$.belowthefold(this, settings) && 71 !$.rightoffold(this, settings)) { 72 $this.trigger("appear"); 73 } else { 74 if (++counter > settings.failure_limit) { 75 return false; 76 } 77 } 78 }); 79 80 } 81 82 if(options) { 83 if (undefined !== options.failurelimit) { 84 options.failure_limit = options.failurelimit; 85 delete options.failurelimit; 86 } 87 if (undefined !== options.effectspeed) { 88 options.effect_speed = options.effectspeed; 89 delete options.effectspeed; 90 } 91 92 $.extend(settings, options); 93 } 94 95 $container = (settings.container === undefined ||settings.container === window) ? $window : $(settings.container); 96 97 if (0 === settings.event.indexOf("scroll")) { 98 $container.bind(settings.event, function(event) { 99 return update(); 100 }); 101 } 102 103 this.each(function() { 104 var self = this; 105 var $self = $(self); 106 107 self.loaded = false; 108 109 $self.one("appear", function() { 110 if (!this.loaded) { 111 if (settings.appear) { 112 var elements_left = elements.length; 113 settings.appear.call(self, elements_left, settings); 114 } 115 $("<img />").bind("load", function() { 116 $self.hide().attr("src", $self.data(settings.data_attribute))[settings.effect](settings.effect_speed); 117 self.loaded = true; 118 var temp = $.grep(elements, function(element) { 119 return !element.loaded; 120 }); 121 elements = $(temp); 122 123 if (settings.load) { 124 var elements_left = elements.length; 125 settings.load.call(self, elements_left, settings); 126 } 127 }) 128 .attr("src", $self.data(settings.data_attribute)); 129 } 130 }); 131 132 if (0 !== settings.event.indexOf("scroll")) { 133 $self.bind(settings.event, function(event) { 134 if (!self.loaded) { 135 $self.trigger("appear"); 136 } 137 }); 138 } 139 }); 140 141 $window.bind("resize", function(event) { 142 update(); 143 }); 144 145 update(); 146 147 return this; 148 }; 149 150 $.belowthefold = function(element, settings) { 151 var fold; 152 153 if (settings.container === undefined || settings.container === window) { 154 fold = $window.height() + $window.scrollTop(); 155 } else { 156 fold = $(settings.container).offset().top + $(settings.container).height(); 157 } 158 159 return fold <= $(element).offset().top - settings.threshold; 160 }; 161 162 $.rightoffold = function(element, settings) { 163 var fold; 164 165 if (settings.container === undefined || settings.container === window) { 166 fold = $window.width() + $window.scrollLeft(); 167 } else { 168 fold = $(settings.container).offset().left + $(settings.container).width(); 169 } 170 171 return fold <= $(element).offset().left - settings.threshold; 172 }; 173 174 $.abovethetop = function(element, settings) { 175 var fold; 176 177 if (settings.container === undefined || settings.container === window) { 178 fold = $window.scrollTop(); 179 } else { 180 fold = $(settings.container).offset().top; 181 } 182 183 return fold >= $(element).offset().top + settings.threshold + $(element).height(); 184 }; 185 186 $.leftofbegin = function(element, settings) { 187 var fold; 188 189 if (settings.container === undefined || settings.container === window) { 190 fold = $window.scrollLeft(); 191 } else { 192 fold = $(settings.container).offset().left; 193 } 194 195 return fold >= $(element).offset().left + settings.threshold + $(element).width(); 196 }; 197 198 $.inviewport = function(element, settings) { 199 return !$.rightofscreen(element, settings) && !$.leftofscreen(element, settings) && 200 !$.belowthefold(element, settings) && !$.abovethetop(element, settings); 201 }; 202 203 $.extend($.expr[':'], { 204 "below-the-fold" : function(a) { return $.belowthefold(a, {threshold : 0}); }, 205 "above-the-top" : function(a) { return !$.belowthefold(a, {threshold : 0}); }, 206 "right-of-screen": function(a) { return $.rightoffold(a, {threshold : 0}); }, 207 "left-of-screen" : function(a) { return !$.rightoffold(a, {threshold : 0}); }, 208 "in-viewport" : function(a) { return !$.inviewport(a, {threshold : 0}); }, 209 "above-the-fold" : function(a) { return !$.belowthefold(a, {threshold : 0}); }, 210 "right-of-fold" : function(a) { return $.rightoffold(a, {threshold : 0}); }, 211 "left-of-fold" : function(a) { return !$.rightoffold(a, {threshold : 0}); } 212 }); 213 214 })(jQuery, window);
Lazy Load 依赖于 jQuery. 请将下列代码加入页面 head
区域:
你必须修改 HTML 代码. 在 src
属性中设置展位符图片, demo 页面使用 1x1 像素灰色 GIF 图片. 并且需要将真实图片的 URL 设置到 data-original
属性. 这里可以定义特定的 class
以获得需要延迟加载的图片对象. 通过这种方法你可以简单地控制插件绑定.
处理图片的代码如下.
这将使所有 class
为 lazy
的图片将被延迟加载. 可以参考基本选项 demo
几乎所有浏览器的 JavaScript 都是激活的. 然而可能你仍希望能在不支持 JavaScript 的客户端展示真实图片. 当浏览器不支持 JavaScript 时优雅降级, 你可以将真实的图片片段在写 <noscript>
标签内.
可以通过 CSS 隐藏占位符.
在支持 JavaScript 的浏览器中, 你必须在 DOM ready 时将占位符显示出来, 这可以在插件初始化的同时完成.
这些都是可选的, 但如果你希望插件平稳降级这些都是应该做的.
默认情况下图片会出现在屏幕时加载. 如果你想提前加载图片, 可以设置 threshold
选项, 设置 threshold
为 200 令图片在距离屏幕 200 像素时提前加载.
你还可以设定一个占位图片并定义事件来触发加载动作. 这时需要为占位图片设定一个 URL 地址. 透明, 灰色和白色的 1x1 象素的图片已经包含在插件里面.
事件可以是任何 jQuery 时间, 如: click
和 mouseover
. 你还可以使用自定义的事件, 如: sporty
和 foobar
. 默认情况下处于等待状态, 直到用户滚动到窗口上图片所在位置. 在灰色占位图片被点击之前阻止加载图片, 你可以这样做:
当图片完全加载的时候, 插件默认地使用 show()
方法来将图显示出来. 其实你可以使用任何你想用的特效来处理. 下面的代码使用FadeIn
效果. 这是效果演示页面.
你可以将插件用在可滚动容器的图片上, 例如带滚动条的 DIV 元素. 你要做的只是将容器定义为 jQuery 对象并作为参数传到初始化方法里面. 这是水平滚动演示页面和垂直滚动的演示页面.
滚动页面的时候, Lazy Load 会循环为加载的图片. 在循环中检测图片是否在可视区域内. 默认情况下在找到第一张不在可见区域的图片时停止循环. 图片被认为是流式分布的, 图片在页面中的次序和 HTML 代码中次序相同. 但是在一些布局中, 这样的假设是不成立的. 不过你可以通过 failurelimit
选项来控制加载行为.
将 failurelimit
设为 10 令插件找到 10 个不在可见区域的图片是才停止搜索. 如果你有一个猥琐的布局, 请把这个参数设高一点.
Lazy Load 插件的一个不完整的功能, 但是这也能用来实现图片的延迟加载. 下面的代码实现了页面加载完成后再加载. 页面加载完成 5 秒后, 指定区域内的图片会自动进行加载. 这是延迟加载演示页面.
可能在你的页面上埋藏可很多隐藏的图片. 比如插件用在对列表的筛选, 你可以不断地修改列表中各条目的显示状态. 为了提升性能, Lazy Load 默认忽略了隐藏图片. 如果你想要加载隐藏图片, 请将 skip_invisible
设为 false