DIV CSS 佈局教程網

瀑布流圖片佈局實作:定位算法、圖片載入等待與捲動預載
編輯:關於JavaScript     

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

功能描述

  • 依不同選單的屬性值分別載入不同資料
  • 捲動到接近底部時預載,捲到底就渲染 HTML
  • 滑鼠移到選單可切換各圖片列表
  • 滑鼠移到圖片上顯示詳細資訊

從載入到顯示的完整流程

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

HTML

<!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>

JavaScript 主體

/**
 * 瀑布流佈局元件
 * @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 也能完成。

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