DIV CSS 佈局教程網

jQuery 瀑布流插件 Wookmark 完整實戰教學
編輯:JQuery特效代碼     

想讓圖片牆像 Pinterest 那樣自動填滿每一道縫隙?Wookmark 這個老牌 jQuery 外掛就能做到。它會依容器寬度自動計算每行能放幾張圖,再把高度不一的項目往上補齊,省去自己寫定位計算的麻煩。

準備工作

專案已移至 GitHub 維護,可從下列位置取得檔案:

  • 插件下載:
    https://github.com/GBKS/Wookmark-jQuery
  • 官方主頁:
    https://www.wookmark.com/jquery-plugin

下載解壓後,在頁面中依序載入 jQuery 與外掛本身,注意順序不可顛倒:

<script src="jquery-1.8.2.min.js"></script>
<script src="jquery.wookmark.min.js"></script>

HTML 結構

結構非常單純,一層容器包住一組清單即可,每個 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,否則所有項目會全部擠在頁面左上角,這是初學者最常踩到的坑。

搭配 AJAX 動態載入

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);
});

實務上要留意兩點:一是加一個「是否正在載入」的旗標,避免短時間內重複觸發多次請求;二是後端最好提供頁碼或游標參數,才能真正做到無限往下捲動。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved