Jquery瀑布流插件使用介紹
更新時(shí)間：2012年10月25日 16:14:36 作者：
瀑布流布局在目前貌似很火爆，具體的分析、原理、用到的知識(shí)等等可以看看以下幾位牛人寫(xiě)的東西
淺談個(gè)人在瀑布流網(wǎng)頁(yè)的實(shí)現(xiàn)中遇到的問(wèn)題和解決方法
折騰:瀑布流布局（基于多欄列表流體布局實(shí)現(xiàn)）
javascript 瀑布流、各大瀑布流簡(jiǎn)析與建議
因?yàn)樽约河胘query比較多，便萌生了把瀑布流做成插件的想法，圖片就借用迅雷UED上的那些美圖吧。
先看看Demo
把代碼放出來(lái)吧
復(fù)制代碼 代碼如下:
;(function($){
var
//參數(shù)
setting={
column_width:204,//列寬
column_className:'waterfall_column',//列的類名
column_space:10,//列間距
cell_selector:'.cell',//要排列的磚塊的選擇器，限定在瀑布流的容器內(nèi)
img_selector:'img',//要加載的圖片的選擇器
auto_imgHeight:true,//是否需要自動(dòng)計(jì)算圖片的高度
fadein:true,//是否漸顯載入
fadein_speed:600,//漸顯速率，單位毫秒
insert_type:1, //磚塊插入方式，1為插入最短那列，2為按序輪流插入
getResource:function(index){ } //獲取動(dòng)態(tài)資源函數(shù),必須返回一個(gè)磚塊元素集合,傳入?yún)?shù)為加載的次數(shù)
},
//
waterfall=$.waterfall={},
$container=null;//容器
waterfall.load_index=0, //加載次數(shù)
$.fn.extend({
waterfall:function(opt){
opt=opt||{};
setting=$.extend(setting,opt);
$container=waterfall.$container=$(this);
waterfall.$columns=creatColumn();
render($(this).find(setting.cell_selector).detach(),false); //重排已存在元素時(shí)強(qiáng)制不漸顯
waterfall._scrollTimer2=null;
$(window).bind('scroll',function(){
clearTimeout(waterfall._scrollTimer2);
waterfall._scrollTimer2=setTimeout(onScroll,300);
});
waterfall._scrollTimer3=null;
$(window).bind('resize',function(){
clearTimeout(waterfall._scrollTimer3);
waterfall._scrollTimer3=setTimeout(onResize,300);
});
}
});
function creatColumn(){//創(chuàng)建列
waterfall.column_num=calculateColumns();//列數(shù)
//循環(huán)創(chuàng)建列
var html='';
for(var i=0;i<waterfall.column_num;i++){
html+='<div class="'+setting.column_className+'" style="width:'+setting.column_width+'px; display:inline-block; *display:inline;zoom:1; margin-left:'+setting.column_space/2+'px;margin-right:'+setting.column_space/2+'px; vertical-align:top; overflow:hidden"></div>';
}
$container.prepend(html);//插入列
return $('.'+setting.column_className,$container);//列集合
}
function calculateColumns(){//計(jì)算需要的列數(shù)
var num=Math.floor(($container.innerWidth())/(setting.column_width+setting.column_space));
if(num<1){ num=1; } //保證至少有一列
return num;
}
function render(elements,fadein){//渲染元素
if(!$(elements).length) return;//沒(méi)有元素
var $columns = waterfall.$columns;
$(elements).each(function(i){
if(!setting.auto_imgHeight||setting.insert_type==2){//如果給出了圖片高度，或者是按順序插入，則不必等圖片加載完就能計(jì)算列的高度了
if(setting.insert_type==1){
insert($(elements).eq(i),setting.fadein&&fadein);//插入元素
}else if(setting.insert_type==2){
insert2($(elements).eq(i),i,setting.fadein&&fadein);//插入元素
}
return true;//continue
}
if($(this)[0].nodeName.toLowerCase()=='img'||$(this).find(setting.img_selector).length>0){//本身是圖片或含有圖片
var image=new Image;
var src=$(this)[0].nodeName.toLowerCase()=='img'?$(this).attr('src'):$(this).find(setting.img_selector).attr('src');
image.onload=function(){//圖片加載后才能自動(dòng)計(jì)算出尺寸
image.onreadystatechange=null;
if(setting.insert_type==1){
insert($(elements).eq(i),setting.fadein&&fadein);//插入元素
}else if(setting.insert_type==2){
insert2($(elements).eq(i),i,setting.fadein&&fadein);//插入元素
}
image=null;
}
image.onreadystatechange=function(){//處理IE等瀏覽器的緩存問(wèn)題：圖片緩存后不會(huì)再觸發(fā)onload事件
if(image.readyState == "complete"){
image.onload=null;
if(setting.insert_type==1){
insert($(elements).eq(i),setting.fadein&&fadein);//插入元素
}else if(setting.insert_type==2){
insert2($(elements).eq(i),i,setting.fadein&&fadein);//插入元素
}
image=null;
}
}
image.src=src;
}else{//不用考慮圖片加載
if(setting.insert_type==1){
insert($(elements).eq(i),setting.fadein&&fadein);//插入元素
}else if(setting.insert_type==2){
insert2($(elements).eq(i),i,setting.fadein&&fadein);//插入元素
}
}
});
}
function public_render(elem){//異步數(shù)據(jù)渲染接口函數(shù)
render(elem,true);
}
function insert($element,fadein){//把元素插入最短列
if(fadein){//漸顯
$element.css('opacity',0).appendTo(waterfall.$columns.eq(calculateLowest())).fadeTo(setting.fadein_speed,1);
}else{//不漸顯
$element.appendTo(waterfall.$columns.eq(calculateLowest()));
}
}
function insert2($element,i,fadein){//按序輪流插入元素
if(fadein){//漸顯
$element.css('opacity',0).appendTo(waterfall.$columns.eq(i%waterfall.column_num)).fadeTo(setting.fadein_speed,1);
}else{//不漸顯
$element.appendTo(waterfall.$columns.eq(i%waterfall.column_num));
}
}
function calculateLowest(){//計(jì)算最短的那列的索引
var min=waterfall.$columns.eq(0).outerHeight(),min_key=0;
waterfall.$columns.each(function(i){
if($(this).outerHeight()<min){
min=$(this).outerHeight();
min_key=i;
}
});
return min_key;
}
function getElements(){//獲取資源
$.waterfall.load_index++;
return setting.getResource($.waterfall.load_index,public_render);
}
waterfall._scrollTimer=null;//延遲滾動(dòng)加載計(jì)時(shí)器
function onScroll(){//滾動(dòng)加載
clearTimeout(waterfall._scrollTimer);
waterfall._scrollTimer=setTimeout(function(){
var $lowest_column=waterfall.$columns.eq(calculateLowest());//最短列
var bottom=$lowest_column.offset().top+$lowest_column.outerHeight();//最短列底部距離瀏覽器窗口頂部的距離
var scrollTop=document.documentElement.scrollTop||document.body.scrollTop||0;//滾動(dòng)條距離
var windowHeight=document.documentElement.clientHeight||document.body.clientHeight||0;//窗口高度
if(scrollTop>=bottom-windowHeight){
render(getElements(),true);
}
},100);
}
function onResize(){//窗口縮放時(shí)重新排列
if(calculateColumns()==waterfall.column_num) return; //列數(shù)未改變，不需要重排
var $cells=waterfall.$container.find(setting.cell_selector);
waterfall.$columns.remove();
waterfall.$columns=creatColumn();
render($cells,false); //重排已有元素時(shí)強(qiáng)制不漸顯
}
})(jQuery);
貌似把代碼貼進(jìn)來(lái)格式有點(diǎn)亂了，哎先不管了。上面的代碼要是看不清可以在demo頁(yè)直接查看源文件。
插件使用方法：
復(fù)制代碼 代碼如下:
$(selector).waterfall(opt); //其中selector為瀑布流容器的選擇器，opt為配置參數(shù)對(duì)象
所需的html結(jié)構(gòu)：html結(jié)構(gòu)可以就是一個(gè)空容器元素，如<div id=”container”></div>，里面的磚塊元素通過(guò)動(dòng)態(tài)加載進(jìn)來(lái)。當(dāng)然也可以預(yù)先放一些磚塊進(jìn)去，如demo頁(yè)中的
復(fù)制代碼 代碼如下:
<div id="container">
<div class="cell"><img src="P_000.jpg" /><p>00</p></div>
<div class="cell"><img src="P_001.jpg" /><p>01</p></div>
<div class="cell"><img src="P_002.jpg" /><p>02</p></div>
<div class="cell"><img src="P_003.jpg" /><p>03</p></div>
<div class="cell"><img src="P_004.jpg" /><p>04</p></div>
<div class="cell"><img src="P_005.jpg" /><p>05</p></div>
<div class="cell"><img src="P_006.jpg" /><p>06</p></div>
<div class="cell"><img src="P_007.jpg" /><p>07</p></div>
<div class="cell"><img src="P_008.jpg" /><p>08</p></div>
<div class="cell"><img src="P_009.jpg" /><p>09</p></div>
<div class="cell"><img src="P_010.jpg" /><p>10</p></div>
<div class="cell"><img src="P_011.jpg" /><p>11</p></div>
<div class="cell"><img src="P_012.jpg" /><p>12</p></div>
<div class="cell"><img src="P_013.jpg" /><p>13</p></div>
<div class="cell"><img src="P_014.jpg" /><p>14</p></div>
<div class="cell"><img src="P_015.jpg" /><p>15</p></div>
<div class="cell"><img src="P_016.jpg" /><p>16</p></div>
<div class="cell"><img src="P_017.jpg" /><p>17</p></div>
<div class="cell"><img src="P_018.jpg" /><p>18</p></div>
<div class="cell"><img src="P_019.jpg" /><p>19</p></div>
</div>
下面詳細(xì)說(shuō)下配置參數(shù)對(duì)象opt的各屬性的作用及其默認(rèn)值。
column_width:204 //瀑布流是由列組成的，該參數(shù)規(guī)定了每列的寬度，該參數(shù)會(huì)直接影響到瀑布流的列數(shù)
column_className:'waterfall_column' //列的類名，便于自定義樣式
column_space:10 //列與列之間的間距
cell_selector:'.cell' //要排列的磚塊的選擇器，限定在瀑布流的容器內(nèi)，即插件是通過(guò)這個(gè)選擇器來(lái)獲取磚塊元素的,并且是在瀑布流的容器內(nèi)來(lái)查找這個(gè)選擇器匹配的元素。
img_selector:'img' //要加載的圖片的選擇器。如果你的瀑布流要加載的磚塊元素的主題內(nèi)容是大小不固定的圖片，則該參數(shù)就是這些圖片的選擇器，插件需要獲取這些圖片來(lái)進(jìn)行計(jì)算。
auto_imgHeight:true //是否需要自動(dòng)計(jì)算圖片的高度，如果圖片的大小是固定的，則把該參數(shù)設(shè)為false吧
fadein:true //是否漸顯載入
fadein_speed:600 //漸顯速率，單位毫秒
insert_type:1 //磚塊插入方式，1為插入最短那列，2為按序輪流插入
getResource:function(index,render){ } //獲取動(dòng)態(tài)資源函數(shù),必須返回一個(gè)磚塊元素集合，傳入的第一個(gè)參數(shù)index為已加載的次數(shù)，第二個(gè)參數(shù)為渲染函數(shù)，它可以接受一個(gè)磚頭元素集合作為參數(shù)，如果是使用ajax加載數(shù)據(jù)，則得到數(shù)據(jù)后要手動(dòng)調(diào)用該函數(shù)來(lái)進(jìn)行渲染 。每次到達(dá)瀑布流底部時(shí)會(huì)自動(dòng)觸發(fā)該函數(shù)來(lái)加載更多資源。
吐槽時(shí)間：
瀑布流加載的內(nèi)容一般都寬度相同，高度不同的圖片，如果能預(yù)先知道圖片的高度，那就簡(jiǎn)單多了，但如果不能，則必須等到圖片加載后才能計(jì)算出圖片的高度，這是瀑布流最煩人的地方，也正是因?yàn)檫@樣，如果是那些不知道高度的圖片，則插入的順序可能會(huì)有些混亂，而且每次刷新順序都不同，因?yàn)槊繌垐D片加載完成的先后順序并不是固定的，也許這次這個(gè)快一點(diǎn)，下次那個(gè)快一點(diǎn)。所以如果圖片高度事先不知道，則整個(gè)磚塊的高度也會(huì)不知道，必須等磚塊里的圖片加載完成后才能算出磚塊的高度。如果是這樣但又想保證磚塊的插入順序，則建議使用按順序輪流插入的方式插入磚塊，即把insert_type參數(shù)設(shè)為2。因?yàn)槭遣寮?，所以要考慮使用簡(jiǎn)便，但使用起來(lái)越簡(jiǎn)便，插件內(nèi)部就會(huì)越復(fù)雜，漏洞、bug也會(huì)增多，所以我會(huì)繼續(xù)完善這個(gè)插件。
本插件支持IE6+、chrome、firefox、opera、safari等主流瀏覽器。
您可能感興趣的文章:
- jQuery 瀑布流 浮動(dòng)布局（一）(延遲AJAX加載圖片)
- jQuery Masonry瀑布流插件使用詳解
- jQuery瀑布流插件Wookmark使用實(shí)例
- jQuery實(shí)現(xiàn)瀑布流布局詳解（PC和移動(dòng)端）
- jQuery 瀑布流 絕對(duì)定位布局（二）(延遲AJAX加載圖片)
- jQuery實(shí)現(xiàn)瀑布流布局
- jQuery.lazyload+masonry改良圖片瀑布流代碼
- jquery簡(jiǎn)單瀑布流實(shí)現(xiàn)原理及ie8下測(cè)試代碼
- jQuery向下滾動(dòng)即時(shí)加載內(nèi)容實(shí)現(xiàn)的瀑布流效果
- jQuery實(shí)現(xiàn)動(dòng)態(tài)加載瀑布流
相關(guān)文章
基于jQuery實(shí)現(xiàn)點(diǎn)擊列表加載更多效果
這篇文章主要為大家詳細(xì)介紹了基于jQuery實(shí)現(xiàn)點(diǎn)擊列表加載更多效果的相關(guān)資料，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2016-05-05
artDialog 4.1.5 Dreamweaver代碼提示/補(bǔ)全插件 附下載
artDialog是一個(gè)輕巧且高度兼容的javascript對(duì)話框組件，可讓你的網(wǎng)頁(yè)交互擁有桌面軟件般的用戶體驗(yàn)2012-07-07
下面小編就為大家?guī)?lái)一篇深入理解jquery中的事件與動(dòng)畫(huà)。小編覺(jué)得挺不錯(cuò)的，現(xiàn)在就分享給大家，也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧2016-05-05
這篇文章主要為大家詳細(xì)介紹了jQuery表單驗(yàn)證之密碼確認(rèn)的實(shí)現(xiàn)代碼，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2017-05-05
這篇文章主要為大家詳細(xì)介紹了jquery實(shí)現(xiàn)計(jì)算器小功能，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2022-07-07
因?yàn)楹笈_(tái)要用到該功能，熟悉了下jquery的選擇器功能。便實(shí)現(xiàn)了jquery版的全選。感覺(jué)jquery確實(shí)比用javascript節(jié)省很多勞力啊..呵呵2011-03-03
jQuery插件HighCharts實(shí)現(xiàn)2D柱狀圖、折線圖的組合多軸圖效果示例【附demo源碼下載】
這篇文章主要介紹了jQuery插件HighCharts實(shí)現(xiàn)2D柱狀圖、折線圖的組合多軸圖效果,結(jié)合實(shí)例形式分析了jQuery使用HighCharts插件同時(shí)繪制柱狀圖、折線圖的實(shí)現(xiàn)技巧與相關(guān)操作步驟,并附帶demo源碼供讀者下載參考,需要的朋友可以參考下2017-03-03
這篇文章主要介紹了jquery淡入淡出效果簡(jiǎn)單實(shí)現(xiàn)方法,以完整實(shí)例形式分析了jQuery中fadeIn及fadeOut實(shí)現(xiàn)淡入淡出的相關(guān)技巧,需要的朋友可以參考下2016-01-01
jQuery實(shí)現(xiàn)鼠標(biāo)經(jīng)過(guò)提示信息的地圖熱點(diǎn)效果
這是一個(gè)升級(jí)版本，更新了一個(gè)在IE8里的小問(wèn)題，加入了提示框的內(nèi)容自動(dòng)換行處理(北京點(diǎn)上有演示)！估計(jì)差不多該是最后樣式了。IE6、IE8、谷歌、火狐、測(cè)試正常。2015-04-04
jquery移動(dòng)端TAB觸屏切換實(shí)現(xiàn)效果
這篇文章主要介紹了jquery移動(dòng)端TAB觸屏切換實(shí)現(xiàn)效果案例，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2015-10-10