Jquery瀑布流插件使用介紹_jquery

瀑布流佈局淺析

淺談個人在瀑布流網頁的實現中遇到的問題和解決方法

折騰:瀑布流佈局（基於多欄列表流體佈局實現）

javascript 瀑布流、各大瀑布流簡析與建議

因為自己用jquery比較多，便萌生了把瀑布流做成插件的想法，圖片就藉用迅雷UED上的那些美圖吧。

先看看Demo

把代碼放出來吧

複製代碼 程式碼如下:

;(function($){
var
//参数
setting={
column_width:204,//列宽
column_className:'waterfall_column',//列的类名
column_space:10,//列间距
cell_selector:'.cell',//要排列的砖块的选择器，限定在瀑布流的容器内
img_selector:'img',//要加载的图片的选择器
auto_imgHeight:true,//是否需要自动计算图片的高度
fadein:true,//是否渐显载入
fadein_speed:600,//渐显速率，单位毫秒
insert_type:1, //砖块插入方式，1为插入最短那列，2为按序轮流插入
getResource:function(index){ } //获取动态资源函数,必须返回一个砖块元素集合,传入参数为加载的次数
},
//
waterfall=$.waterfall={},
$container=null;//容器
waterfall.load_index=0, //加载次数
$.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); //重排已存在元素时强制不渐显
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(){//创建列
waterfall.column_num=calculateColumns();//列数
//循环创建列
var html='';
for(var i=0;ihtml+='

';
}
$container.prepend(html);//插入欄位
return $('.' setting.column_className,$container);//欄集合
}
function calculateColumns(){//計算所需的列數
var num=Math.floor(($container.innerWidth())/(setting.column_width setting.column_space));
if(numreturn num;
}
function render(elements,fadein){//渲染元素
if(!$(elements).length) return;//沒有元素
var $columns = waterfall.$columns;
$(elements).each(function(i){
if(!setting.auto_imgHeight||setting.insert_type==2 ){//如果給出了圖片高度，或者是按順序插入，則不必等圖片加載完就能計算列的高度了
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() {//圖片載入後才能自動計算出尺寸
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等瀏覽器的快取問題：圖片快取後不會再觸發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){//非同步資料渲染介面函數
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(){//計算最短的那列的索引
var min=waterfall.$columns.eq(0).outerHeight(),min_key=0;
waterfall.$columns.each(function(i){
if($ (this).outerHeight()min=$(this).outerHeight();
min_key=i;
}
});
return min_key;
}
function getElements(){//取得資源
$.waterfall.load_index ;
return setting.getResource($.waterfall.load_index,public_render); }
waterfall._scroll🎜>水=null;//延遲滾動載入計時器
function onScroll(){//滾動載入
clearTimeout(waterfall._scrollTimer);
waterfall._scrollTimer=setTimeout(function(){
var $🎜>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;//滾動條距離
var windowHeight=document.documentElement.clientHeight||document.body.clientHeight||0; //視窗高度
if(scrollTop>=bottom-windowHeight){
render(getElements(),true);
}
},100);
}
function onResize (){//視窗縮放時重新排列
if(calculateColumns()==waterfall.column_num) return; //列數未改變，不需要重排
var $cells=waterfall.$container.find (setting.cell_selector);
waterfall.$columns.remove();
waterfall.$columns=creatColumn();
render($cells,false); //重排已有元素時強制不漸顯
}
})(jQuery);

貌似把程式碼貼進來格式有點亂了，哎先不管了。上面的程式碼要是看不清楚可以在demo頁直接查看原始檔。
外掛程式使用方法：

複製程式碼 程式碼如下:

$(selector).waterfall(opt); //其中selector為瀑布流容器的選擇器，opt為配置參數物件

所需的html結構：html結構可以就是一個空容器元素，如

，裡面的磚塊元素透過動態載入進來。當然也可以預先放一些磚塊進去，如demo頁中的

複製程式碼 程式碼如下:

00

01

02

03

04

05

06

div>

07

08

09

10

11

12 p>

13

14

15

16

17

18

19

下面詳細說下配置參數物件opt的各屬性的作用及其預設值。

column_width:204  //瀑布流是由列組成的，該參數規定了每列的寬度，該參數會直接影響到瀑布流的列數

column_className:'waterfall_column'   //列的類別名，方便自訂樣式

column_space:10    //列與欄位之間的間距

cell_selector:'.cell'   //要排列的磚塊的選擇器，限定在瀑布流的容器內，即插件是透過這個選擇器來取得磚塊元素的,並且是在瀑布流的容器內來尋找這個選擇器所符合的元素。

img_selector:'img'  //要載入的圖片的選擇器。如果你的瀑布流要載入的磚塊元素的主題內容是大小不固定的圖片，則該參數就是這些圖片的選擇器，外掛程式需要取得這些圖片來進行計算。

auto_imgHeight:true  //是否需要自動計算圖片的高度，如果圖片的大小是固定的，則把該參數設為false吧

fadein:true  //是否漸顯載入

fadein_speed:600  //漸顯速率，單位毫秒

insert_type:1  //磚塊插入方式，1為插入最短那列，2為依序輪流插入

getResource:function(index,render){ } //取得動態資源函數,必須傳回一個磚塊元素集合，傳入的第一個參數index為已載入的次數，第二個參數為渲染函數，它可以接受一個磚頭元素集合作為參數，如果是使用ajax載入數據，則得到數據後要手動調用該函數來進行渲染。每次到達瀑布流底部時會自動觸發該函數來載入更多資源。

吐槽時間：

瀑布流加載的內容一般都寬度相同，高度不同的圖片，如果能預先知道圖片的高度，那就簡單多了，但如果不能，則必須等到圖片加載後才能計算出圖片的高度，這是瀑布流最煩人的地方，也正是因為這樣，如果是那些不知道高度的圖片，則插入的順序可能會有些混亂，而且每次刷新順序都不同，因為每張圖片加載完成的先後順序並不是固定的，也許這次這個快一點，下次那個快一點。所以如果圖片高度事先不知道，則整個磚塊的高度也會不知道，必須等磚塊裡的圖片載入完成後才能算出磚塊的高度。如果是這樣但又想保證磚塊的插入順序，則建議使用依序輪流插入的方式插入磚塊，即把insert_type參數設為2。因為是插件，所以要考慮使用簡便，但使用起來越簡便，插件內部就會越複雜，漏洞、bug也會增多，所以我會繼續完善這個插件。

本插件支援IE6 、chrome、firefox、opera、safari等主流瀏覽器。