瀑布流佈局非常適合大量圖片的展示,一改過去裁剪圖片尺寸統一的排版,每張圖片都能完全展示,並錯落有致,讓人眼前一亮。 版本: jQuery v1.4.3+ jQuery Wookmark Load v1.4.8 註意事項: 項目中的 img 元素的 width 和 height 屬性需要寫,否則定位會 ...
瀑布流佈局非常適合大量圖片的展示,一改過去裁剪圖片尺寸統一的排版,每張圖片都能完全展示,並錯落有致,讓人眼前一亮。
- 版本:
- jQuery v1.4.3+
- jQuery Wookmark Load v1.4.8
- 註意事項:
-
項目中的 img 元素的 width 和 height 屬性需要寫,否則定位會不准確。(可以用 JavaScript 實時獲取圖片的寬高,但圖片數量過多時,這將是一件不靠譜的事情。)
線上實例
實例預覽 Example 基本示例
實例預覽 AMD 載入器
實例預覽 Endless scroll 無限滾動
實例預覽 Flexible width 彈性佈局
實例預覽 Lightbox 支持燈窗插件
實例預覽 Load it all 動態讀取圖片尺寸
實例預覽 Placeholders 底部占位符
實例預覽 PHP server PHP 載入數據
實例預覽 Remote API 遠程 API 載入數據
實例預覽 Filtering Or 篩選功能
實例預覽 Filtering And 篩選功能
實例預覽 Filtering Only 篩選功能
實例預覽 Filtering Fade 篩選功能
實例預覽 sorting排序基本示例
實例預覽 stamping基本示例
使用方法
載入 JavaScript 文件
<script src="jquery.js"></script>
<script src="jquery.wookmark.js"></script>
CSS 樣式
/*
* 父容器需要設置相對定位
* 項目需要設置隱藏
*/
#list{position:relative;}
#list li{display:none;}
DOM 結構
<!--
本例中,$("#list") 就是父容器,內部的 li 就是要進行瀑布流佈局的項目。當然也可以使用 div 或其他標簽的來寫。
項目中的 img 元素的 width 和 height 屬性需要寫,否則定位會不准確。
-->
<ul id="list">
<li><img src="pic_1.jpg" width="200" height="283"><p>text</p></li>
<li><img src="pic_2.jpg" width="200" height="300"><p>text</p></li>
...
<li><img src="pic_n.jpg" width="200" height="252"><p>text</p></li>
</ul>
調用 Wookmark
$('#list li').wookmark();
// 自定義參數調用
$('#list li').wookmark({
container: $('#list'),
offset: 10,
itemWidth: 200
});
手動觸發佈局事件
// 根據需要,可以進行手動觸發重新佈局
$('#list').trigger('refreshWookmark');
參數說明
名稱 | 預設值 | 說明 |
---|---|---|
container | $('body') | 父容器。自定義時需要給父容器設置 CSS 屬性 "position: relative"。 |
align | 'center' | 對齊方向,可設置為:"left", "right", "center"。 |
direction | undefined | 排序方向。可設置為:"left"(從左至右), "right"(從右至左)
若不設置,則判斷 align 為 "right" 時,direction 為 "right",否則預設為 "left"。 |
autoResize | false | 是否在瀏覽器視窗大小變化時進行重新佈局。 |
resizeDelay | 50 | 檢測自動重新佈局的間隔時間 (ms)。 |
itemWidth | 0 | 列表項目的寬度 (px 或 %)。 |
flexibleWidth | 0 | 列表項目自適應的最大寬度。該項設置時,itemWidth 的值作為列表項目的最小寬度。 |
offset | 2 | 列表項目的間距 (px),橫向縱向相同。 |
verticalOffset | undefined | 列表項目縱向的間距 (px),與 offset 配合即可分別設置橫向與縱向的間距。 |
outerOffset | 0 | 外部間距,與父容器頂部的間距。 |
ignoreInactiveItems | true | 是否隱藏被過濾的項目。 |
fillEmptySpace | false | 是否填充底部占位符。占位符的 class 為 "wookmark-placeholder"。 |
comparator | null | 自定義排序方法。 |
possibleFilters | [] | |
onLayoutChanged | undefined | 佈局變化時觸發的函數。 |
下載