想讓圖片牆像 Pinterest 那樣自動填滿每一道縫隙?Wookmark 這個老牌 jQuery 外掛就能做到。它會依容器寬度自動計算每行能放幾張圖,再把高度不一的項目往上補齊,省去自己寫定位計算的麻煩。
專案已移至 GitHub 維護,可從下列位置取得檔案:
下載解壓後,在頁面中依序載入 jQuery 與外掛本身,注意順序不可顛倒:
<script src="jquery-1.8.2.min.js"></script>
<script src="jquery.wookmark.min.js"></script>
結構非常單純,一層容器包住一組清單即可,每個 li 就是一個瀑布流單元:
<div id="main">
<ul id="tiles">
<li><img src="images/1.jpg"></li>
<li><img src="images/2.jpg"></li>
<li><img src="images/3.jpg"></li>
</ul>
</div>
只要選中所有項目並呼叫 wookmark(),它就會套用預設設定完成排版:
<script>
jQuery(function($){
$('#tiles li').wookmark();
});
</script>
實務上多半需要微調間距與單元寬度,這時可以傳入選項物件:
<script>
jQuery(function($){
$('#tiles li').wookmark({
autoResize: true, // 視窗尺寸改變時自動重新排版
container: $('#container'), // 容器名稱,該容器必須具備 position:relative
offset: 12, // 相鄰元素之間的間距
itemWidth: 222, // 指定單元寬度
resizeDelay: 50 // 縮放後的延遲毫秒數,預設 50
});
});
</script>
特別提醒 container 這項:對應的容器一定要在 CSS 中宣告 position:relative,否則所有項目會全部擠在頁面左上角,這是初學者最常踩到的坑。
Wookmark 可以與 AJAX 搭配,做出一頁頁追加的相片牆。新資料插入 DOM 之後,必須重新執行一次排版才會生效:
var handler = $('#tiles li');
handler.wookmark(options);
如果先前已經綁定過事件,重新執行前先清除舊的定位資料,避免樣式錯亂:
handler.wookmarkClear();
很多人問捲動載入怎麼寫,以下是一個可直接運作的骨架:
var handler = null;
// 定義基本設定
var options = {
autoResize: true,
container: $('#main'),
offset: 2,
itemWidth: 210
};
// 定義捲動事件處理函式
function onScroll(event) {
// 判斷是否接近底部(此處以距離底部 100px 作為觸發點)
var closeToBottom = ($(window).scrollTop() + $(window).height() > $(document).height() - 100);
if (closeToBottom) {
// 以 AJAX 取得下一批資料
$.ajax({
url: "data.html",
dataType: "html",
success: function (html) {
// 把新資料附加到列表中
$('#waterfall').append(html);
// 清除舊的定位資訊
if (handler) handler.wookmarkClear();
// 重新建立 Wookmark 物件
handler = $('#waterfall li');
handler.wookmark(options);
}
});
}
};
$(document).ready(function () {
// 綁定捲動事件
$(document).bind('scroll', onScroll);
// 首次排版
handler = $('#waterfall li');
handler.wookmark(options);
});
實務上要留意兩點:一是加一個「是否正在載入」的旗標,避免短時間內重複觸發多次請求;二是後端最好提供頁碼或游標參數,才能真正做到無限往下捲動。