瀑布流(Masonry)應用在圖片牆、素材網站上很常見。它的核心難題不是排版,而是「圖片高度在載入完成前是未知的」——因此必須等圖片真的載入後才能算位置。本文拆解完整的實作思路與程式碼。

1. 載入資料
2. 拼接 HTML 寫入頁面
3. 檢查剛寫入的 img 是否全部載入完成 → 是則進入步驟 5,否則進入步驟 4
4. 等待圖片載入完成
5. 計算每個元素的位置
一開始最頭痛的就是定位。後來的解法是:先算出總共有幾列,把「每一列目前的高度」放進一個陣列;每當一張圖載入完成,就找出陣列中的最小值(也就是目前最矮的那一列),把該圖的 top 設為這個值,接著把圖片高度累加回該列,再處理下一張。這樣視覺上各列高度會保持相對平衡。
// 找出目前最矮的那一列
_getLowestCol: function () {
var cols = this._cols, min = 0;
for (var i = 1; i < cols.length; i++) {
if (cols[i] < cols[min]) { min = i; }
}
return min;
},
// 為所有圖片定位
_reposition: function () {
var t = this;
t._grids.each(function (i, grid) {
grid = $(grid).show();
var height = grid.outerHeight();
var min = t._getLowestCol();
// 非第一行時加上列間距
if (t._cols[min]) { t._cols[min] += t._rowSpacing; }
grid.animate({
left: (t._colWidth + t._colSpacing) * min,
top: t._cols[min],
opacity: 1
}, 1000);
t._cols[min] += height; // 把高度累加回該列
});
}
滑鼠移到不同選單要切換圖片列表,各自以瀑布流載入。若每次 hover 都重新打一次 API,流量與效能都不划算。解法很簡單:用一個物件記錄「哪個 API 已經載入過」。
var isLoad = {}; // 記錄各來源是否已載入
labelType.mouseover(function () {
var i = $(this).index();
var api = $(this).attr('api'); // 自訂屬性標示資料來源
if (!isLoad[api]) {
isLoad[api] = i;
loadData(wrapper, api);
}
});
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title></title>
<style type="text/css">
* { margin: 0; padding: 0; }
ul, li { list-style-type: none; }
li img { width: 100%; list-style: none; }
</style>
</head>
<body>
<div class="photo_box">
<ul id="container" style="border:1px solid #000; width:80%; height:600px;
overflow:hidden; margin:0 auto; position: relative;"></ul>
<div id="loading" class="loading"
style="text-align: center; margin-top: 20px; font-size: 1.2em;">加載中...</div>
<div id="more" class="more"
style="text-align: center; margin-top: 20px; font-size: 1.2em;">
<input type="button" value="更 多" id="clear" />
</div>
</div>
<script type="text/javascript" src="../../lib/seajs/sea.js"></script>
<script type="text/javascript" src="../../lib/base/1.0.x/base.js"></script>
<script type="text/javascript">
seajs.use(['lib/jquery/1.11.x/index.js', '_example/waterFall_1.1/waterfall.js'],
function ($, waterFall) {
waterFall.init({
container: $('#container'),
dataURL: 'https://www.example.com/api/list',
dataType: 'jsonp',
template:
'<% for (var i = 0; i < data.length; i++) { %>' +
'<li style="display: none;">' +
'<img src=" <%-data[i].room_img%> ">' +
'</li>' +
'<% } %>',
colWidth: 200,
colSpacing: 10,
rowSpacing: 15,
page: 1,
pageEnd: 8 // 限制同時展示的頁數
});
var loadCounter = 1;
function pageNum() {
if (loadCounter >= 3) {
$('#more').show();
$('#loading').hide();
return true;
} else {
loadCounter++;
$('#more').hide();
$('#loading').show();
}
return false;
}
$('#clear').click(function () {
loadCounter = 1;
waterFall._loadNext();
});
});
</script>
</body>
</html>
/**
* 瀑布流佈局元件
* @param {NodeList} options.container 容器
* @param {String} options.dataURL 資料來源
* @param {String} options.dataType json 或 jsonp
* @param {String} options.template 模板字串
* @param {Number} options.colWidth 單張圖寬
* @param {Number} options.colSpacing 列間距
* @param {Number} options.rowSpacing 行間距
* @param {Number} options.page 起始頁碼
* @param {Number} options.pageEnd 結束頁碼
*/
define(function (require, exports, module) {
'use strict';
var Tmpl = require('lib/tmpl/2.1.x/index.js');
var $ = require('lib/jquery/1.11.x/index.js');
var waterFall = {
init: function (options) {
var t = this;
t._container = options.container;
t._template = options.template;
t._colWidth = options.colWidth;
t._colSpacing = options.colSpacing;
t._rowSpacing = options.rowSpacing;
t.dataURL = options.dataURL;
t.dataType = options.dataType;
t.page = options.page;
t.pageEnd = options.pageEnd;
t._switch = false;
// 總寬 / (列寬 + 列間距) = 幾列
t._totalCols = parseInt(t._container.width() / (t._colWidth + t._colSpacing));
// 記錄每列目前高度的陣列
t._cols = new Array(t._totalCols);
for (var i = 0; i < t._cols.length; i++) { t._cols[i] = 0; }
t._loadingPage = options.page || 0;
t._loadNext(options);
// 捲動到底就載入下一批
var lastTime = new Date().getTime();
$(window).scroll(function () {
if (!t._switch) {
// 抑制 IE 下捲動事件的高頻觸發
var thisTime = new Date().getTime();
if (thisTime - lastTime < 50) {
lastTime = thisTime;
return;
}
if ($(window).scrollTop() + $(window).height()
>= document.documentElement.scrollHeight) {
lastTime = thisTime;
t._loadNext();
}
}
});
},
// 載入下一批資料
_loadNext: function () {
var t = this;
t._switch = true;
if (!t.trigger) {
$.ajax({
url: t.dataURL,
data: { page: ++t._loadingPage },
dataType: t.dataType,
success: function (response) {
t.trigger = t._completeLoading(response);
},
error: function () { console.log('Error! 請求有誤'); }
});
}
return false;
},
_completeLoading: function (result) {
var t = this;
if (t._loadingPage >= t.pageEnd) {
$('#more').hide();
$('#loading').html('<p>已經是最後一頁了</p>');
return true;
} else {
t._add(result);
}
return false;
},
// 產生 DOM 並插入
_add: function (result) {
var t = this;
var content = Tmpl.render(t._template, { data: result.data });
// 先放到容器外,避免中途閃現
t._grids = $(content).css({
position: 'absolute',
left: t._container.width(),
top: t._container.height(),
width: t._colWidth,
opacity: 0
});
t._container.append(t._grids);
// 若圖片尚未全部載入,監聽 load / error 後再試一次
if (!t._reposition()) {
t._grids.find('img').bind('load error', function () {
this.loaded = true;
if (t._grids) { t._reposition(); }
});
}
},
_getLowestCol: function () {
var cols = this._cols, min = 0;
for (var i = 1; i < cols.length; i++) {
if (cols[i] < cols[min]) { min = i; }
}
return min;
},
// 定位:全部圖片都載入完成才動手
_reposition: function () {
var t = this;
var allImgsLoaded = true;
t._grids.find('img').each(function (i, img) {
if (!img.loaded && !img.complete) { allImgsLoaded = false; }
return allImgsLoaded;
});
if (allImgsLoaded) {
t._grids.each(function (i, grid) {
grid = $(grid).show();
var height = grid.outerHeight();
var min = t._getLowestCol();
if (t._cols[min]) { t._cols[min] += t._rowSpacing; }
grid.animate({
left: (t._colWidth + t._colSpacing) * min,
top: t._cols[min],
opacity: 1
}, 1000);
t._cols[min] += height;
});
// 容器高度設為最高的那一列
t._container.css('height', Math.max.apply(Math, t._cols));
t._switch = false;
delete t._grids;
}
return allImgsLoaded;
}
};
return waterFall;
});
圖片一定要給固定高度。最穩定的做法是讓伺服器回傳寬高,或在 img 上標明尺寸,讓瀏覽器在圖片下載前就能預留空間,不必等 onload。這也能大幅改善 CLS(累積版面位移)指標。
監聽 error 不只是為了容错。範例已把 error 與 load 一起監聽,載入失敗的圖片才不會讓整個流程卡住。
IntersectionObserver 取代 scroll 判斷。用 $(window).scrollTop() 判斷是否到底,每次捲動都會觸發強制重排。改用 IntersectionObserver 觀察一個放在底部的哨兵元素,效能與程式碼都更乾淨。
純 CSS 也能做瀑布流。若不需要「依序填列」的效果,column-count/columns 這類多欄配置就能實現近似排版;若要維持列序,則可採用 grid 搭配 grid-auto-rows: 10px 與每張圖的 grid-row-end: span N 技巧,完全不寫 JS 也能完成。