瀑布流是圖片牆最經典的排版。本文實作的特點是:不靠 float、也不用絕對定位,而是用 inline-block 讓每一「列」並排,每一列內部再往下堆圖片;新圖片永遠塞進目前最矮的那一列,視覺上就自然形成高低起伏的瀑布效果。

整個模組分成資料與行為兩塊。find_shortest_col() 逐一比對各列的目前高度,回傳最矮那一列的索引;add_item() 把新項目放進那一列;resize_item() 則在視窗尺寸改變、欄數變化時重新配置。而「哪一列剛渲染完」的時機,靠 avalon 的 rendered 鉤子來接續,確保下一次插入時高度數據是準確的。
function getIndex(index) {
if (index < 10) { index = "00" + index; }
else if (index < 100) { index = "0" + index; }
return index;
}
var $ = function(id) { return document.getElementById(id); };
require(["avalon-min"], function(avalon) {
var waterfall = {
load_items : null,
loaded_items : [],
col_num : 0, // 欄數
col_width : 200,
loaded_num : 0,
init_num : 0,
loading : false,
start : 0,
resizing : false,
// 找出目前最矮的那一列
find_shortest_col : function() {
var a = avalon($('row0')).height(), min_i = 0;
for (var i = 1; i < this.col_num; i++) {
var b = avalon($('row' + i)).height();
if (b < a) { min_i = i; a = b; }
}
return min_i;
},
init : function(data) {
this.load_items = data;
this.loaded_items = this.loaded_items.concat(data);
this.waterfall_model = waterfall_model;
this.col_num = Math.floor(avalon(window).width() / this.col_width);
this.init_num = this.col_num;
for (var j = 0; j < this.col_num; j++) waterfall_model.img_list.push([]);
// 第一行:每列各放一張
for (var j = 0; j < this.col_num; j++) {
waterfall_model.img_list[j].push({
src: getIndex(data[j].src), height: data[j].height, text: data[j].text
});
}
this.start = this.col_num;
},
// 載入更多時:放進最矮的列
add_item : function(i) {
var a = this.find_shortest_col();
var c = this.load_items[this.init_num + i];
if (c) waterfall_model.img_list[a].push({
src: getIndex(c.src), height: c.height, text: c.text
});
},
// 視窗縮放時:依既有順序重新配置
resize_item : function(i) {
var a = this.find_shortest_col();
var c = this.loaded_items[this.init_num + i];
if (c) waterfall_model.img_list[a].push({
src: getIndex(c.src), height: c.height, text: c.text
});
}
};
var waterfall_model = avalon.define("waterfall", function(vm) {
vm.img_list = [];
vm.rendered = function() {
// 每次圖片渲染後,才繼續放下一張(確保高度已確定)
if (waterfall.resizing) {
if (waterfall.loaded_num + waterfall.init_num < waterfall.loaded_items.length) {
waterfall.loaded_num++;
waterfall.resize_item(waterfall.loaded_num);
}
} else {
if (waterfall.loaded_num + waterfall.init_num < waterfall.load_items.length) {
waterfall.loaded_num++;
waterfall.add_item(waterfall.loaded_num);
waterfall.start++;
}
}
};
});
avalon.config({ debug: false });
avalon.scan();
// 節流:避免捲動/縮放事件高頻觸發
function debouncer(func, timeout) {
var timeoutID, timeout = timeout || 200;
return function() {
var scope = this, args = arguments;
clearTimeout(timeoutID);
timeoutID = setTimeout(function() {
func.apply(scope, Array.prototype.slice.call(args));
}, timeout);
};
}
avalon.post("test.php?start=0", function(data) {
waterfall.init(data);
}, "json");
// 捲到底就載入下一批
window.onscroll = debouncer(function(e) {
var scrollTop = avalon(window).scrollTop(),
windowHeight = avalon(window).height(),
documentHeight = avalon(document).height();
if (windowHeight + scrollTop == documentHeight) {
avalon.post("test.php?start=" + waterfall.start, function(data) {
waterfall.resizing = false;
waterfall.load_items = data;
waterfall.loaded_items = waterfall.loaded_items.concat(data);
waterfall.loaded_num = waterfall.init_num = 0;
waterfall.add_item(0);
}, "json");
}
});
// 視窗寬度改變時重新計算欄數
window.onresize = debouncer(function(e) {
var k = Math.floor(avalon(window).width() / 200),
detect_left = avalon($('waterFallDetect')).offset().left;
if (Math.abs(detect_left) >= 199) {
waterfall.col_num = Math.floor(avalon(window).width() / waterfall.col_width);
waterfall_model.img_list = [];
for (var j = 0; j < waterfall.col_num; j++) waterfall_model.img_list.push([]);
waterfall.resizing = true;
waterfall.loaded_num = waterfall.init_num = 0;
waterfall.resize_item(0);
}
}, 30);
});
<div id='wrap' ms-controller="waterfall">
<ul ms-each-els="img_list" id='wrap_row'>
<li ms-each-el="els" ms-attr-id='row{{$index}}' data-each-rendered='rendered'>
<p>
<img ms-src="P_{{el.src}}.jpg" width='192' ms-attr-height='{{el.height}}'>
<span>{{el.src}}</span>
</p>
</li>
<li id='waterFallDetect' ms-if='$last'></li>
</ul>
</div>
#wrap ul li {
display:inline-block; *display:inline; zoom:1;
vertical-align:top; font-size:16px;
}
#wrap ul li p {
margin:5px 2.5px; border:1px solid red;
min-width:192px; min-height:100px;
}
#wrap span { display:block; }
#waterFallDetect { width:192px; height:100px; border:1px solid red; }
用 rendered 鉤子接力,而不是盲目 append。因為要判斷「哪一列最矮」,就必須確保上一張圖的 DOM 已經真的插入並計算完高度。這也是為什麼程式碼看起來像是一張一張慢慢加,卻不會出錯。
用 debounce 節流。scroll 與 resize 事件的觸發頻率非常高,沒有節流的瀑布流在低端裝置上很容易卡頓。
偵測欄數變化的方式很巧妙。在最後放一個寬度等於單欄寬的隱藏探針元素,再檢查它 offset().left 是否超過一欄寬,就能反推目前排了幾欄,不必自己重算斷點。
今天的替代方案:如果不需要客製,CSS 的 column-count(多欄)或 grid 都能做出不錯的瀑布流;要維持「先左後右」的閱讀順序則可用 JS 版 Masonry 套件。理解本文的「塞進最矮一列」思路,能幫助你判斷何時該自己寫、何時該用現成套件。
以上就是 avalon 瀑布流的實作說明,希望對你的開發有所幫助。