Wookmark 是一套 jQuery 瀑布流外掛,主要透過 absolute 定位重新排布內容,讓高度不一的卡片自動填滿每一列的空隙。
外掛下載:https://github.com/GBKS/Wookmark-jQuery 官方頁面:https://www.wookmark.com/jquery-plugin
<script src="jquery-1.8.2.min.js"></script>
<script src="jquery.wookmark.min.js"></script>
<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>
jQuery(function ($) {
$('#tiles li').wookmark();
});
jQuery(function ($) {
$('#tiles li').wookmark({
autoResize: true, // 視窗大小改變時重新排布
container: $('#container'), // 容器必須具備 position: relative
offset: 12, // 相鄰元素的間距
itemWidth: 222, // 項目寬度
resizeDelay: 50 // 縮放後的延遲(毫秒)
});
});
container 一定要設 position: relative,否則所有卡片會全部擠在頁面左上角——這是最常見的失敗原因。
新增內容之後必須重新執行一次排布。若之前綁過事件,記得先清除再重建:
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) {
var closeToBottom = ($(window).scrollTop() + $(window).height()
> $(document).height() - 100);
if (closeToBottom) {
$.ajax({
url: "data.html",
dataType: "html",
success: function (html) {
$('#waterfall').append(html);
if (handler) handler.wookmarkClear(); // 清除原來的定位
handler = $('#waterfall li'); // 重新建立物件
handler.wookmark(options);
}
});
}
}
$(document).ready(function () {
$(document).bind('scroll', onScroll);
handler = $('#waterfall li');
handler.wookmark(options);
});
這個範例有兩個必須修正的問題:一是沒有「是否正在載入」的旗標,捲動過程中會連續送出大量重複請求;二是沒有更新頁碼,每次都會抓到同一份資料。加上 isLoading 判斷並在 success 中重設,同時把頁碼帶進請求參數,才能正常運作。另外,瀑布流排版必須在圖片載入完成後才能正確計算高度,建議在 append 之後等待圖片的 load 事件再呼叫 wookmark。