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