Jquery瀑布流插件使用介绍
瀑布流布局浅析
浅谈个人在瀑布流网页的实现中遇到的问题和解决方法
折腾:瀑布流布局（基于多栏列表流体布局实现）
javascript 瀑布流、各大瀑布流简析与建议
因为自己用jquery比较多，便萌生了把瀑布流做成插件的想法，图片就借用迅雷ued上的那些美图吧。
代码如下:
;(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;i<waterfall.column_num;i++){
html+='<p 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"></p>';
}
$container.prepend(html);//插入列
return $('.'+setting.column_classname,$container);//列集合
}
function calculatecolumns(){//计算需要的列数
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;//没有元素
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){
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;//延迟滚动加载计时器
function onscroll(){//滚动加载
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;//滚动条距离
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结构可以就是一个空容器元素，如<p id=”container”></p>，里面的砖块元素通过动态加载进来。当然也可以预先放一些砖块进去，如demo页中的
. 代码如下:
<p id="container">
<p class="cell"><img src="p_000.jpg" /><p>00</p></p>
<p class="cell"><img src="p_001.jpg" /><p>01</p></p>
<p class="cell"><img src="p_002.jpg" /><p>02</p></p>
<p class="cell"><img src="p_003.jpg" /><p>03</p></p>
<p class="cell"><img src="p_004.jpg" /><p>04</p></p>
<p class="cell"><img src="p_005.jpg" /><p>05</p></p>
<p class="cell"><img src="p_006.jpg" /><p>06</p></p>
<p class="cell"><img src="p_007.jpg" /><p>07</p></p>
<p class="cell"><img src="p_008.jpg" /><p>08</p></p>
<p class="cell"><img src="p_009.jpg" /><p>09</p></p>
<p class="cell"><img src="p_010.jpg" /><p>10</p></p>
<p class="cell"><img src="p_011.jpg" /><p>11</p></p>
<p class="cell"><img src="p_012.jpg" /><p>12</p></p>
<p class="cell"><img src="p_013.jpg" /><p>13</p></p>
<p class="cell"><img src="p_014.jpg" /><p>14</p></p>
<p class="cell"><img src="p_015.jpg" /><p>15</p></p>
<p class="cell"><img src="p_016.jpg" /><p>16</p></p>
<p class="cell"><img src="p_017.jpg" /><p>17</p></p>
<p class="cell"><img src="p_018.jpg" /><p>18</p></p>
<p class="cell"><img src="p_019.jpg" /><p>19</p></p>
</p>
下面详细说下配置参数对象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等主流浏览器。