萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery Masonry 瀑布流佈局搭配無限滾動載入完整教學

技術棧

  • jQuery(DOM 操作、AJAX)
  • Masonry(網格佈局引擎)
  • Infinite Scroll(無限滾動)或原生 IntersectionObserver

HTML 結構

<div id="container">
    <!-- 磚塊由後端模板或 JS 渲染 -->
    <div class="box">內容 1</div>
    <div class="box">內容 2</div>
    <!-- ... -->
</div>
<div class="loading" style="display:none; text-align:center; padding:20px;">載入中...</div>
<div id="next-page" style="display:none;"><a href="?page=2">下一頁</a></div>

CSS 基礎樣式

#container { width: 90%; margin: 80px auto; }
.box { width: 300px; margin-bottom: 20px; padding: 20px; box-shadow: 0 2px 8px rgba(0,0,0,0.1); background: white; }
.box img { max-width: 100%; height: auto; }
.loading img { width: 32px; height: 32px; }

初始化 Masonry

const $container = $("#container");
$container.imagesLoaded(function() {
    $container.masonry({
        itemSelector: ".box",
        columnWidth: ".box", // 使用元素寬度作為列寬(響應式)
        gutter: 20,
        percentPosition: true, // 使用百分比定位,配合響應式
        stagger: 30, // 交錯動畫延遲
        transitionDuration: "0.4s"
    });
});

無限滾動:IntersectionObserver 版(現代、無依賴、效能佳)

const sentinel = document.createElement("div");
sentinel.id = "sentinel";
document.querySelector(".loading").parentNode.insertBefore(sentinel, document.querySelector(".loading"));

const observer = new IntersectionObserver(entries => {
    if (entries[0].isIntersecting && !window.loading) {
        loadNextPage();
    }
}, {rootMargin: "200px"}); // 提前 200px 觸發

observer.observe(sentinel);

let currentPage = 1;
const maxPages = 10; // 或從後端獲取
let loading = false;

async function loadNextPage() {
    if (loading || currentPage >= maxPages) return;
    loading = true;
    $(".loading").show();

    try {
        currentPage++;
        const res = await fetch(`?page=${currentPage}`, {headers: {"X-Requested-With": "XMLHttpRequest"}});
        const html = await res.text();
        const $items = $(html).find(".box"); // 假設後端回傳片段

        if ($items.length === 0) {
            observer.unobserve(sentinel);
            $(".loading").html("沒有更多資料了").delay(2000).fadeOut();
            return;
        }

        // Masonry appended 方法:高效插入新元素
        $container.append($items).masonry("appended", $items).masonry("layout");
        $items.imagesLoaded(() => $container.masonry("layout")); // 圖片載入後重新佈局
    } catch (err) {
        console.error(err);
        $(".loading").html("載入失敗,請重試").delay(2000).fadeOut();
        currentPage--; // 回滾頁碼
    } finally {
        loading = false;
        $(".loading").hide();
    }
}

後端配合(PHP 範例)

<?php
// data.php
$page = max(1, intval($_GET['page'] ?? 1));
$size = 20;
$offset = ($page - 1) * $size;

$pdo = new PDO("mysql:host=localhost;dbname=test", "root", "root");
$stmt = $pdo->prepare("SELECT title, content, image FROM posts LIMIT ?, ?");
$stmt->execute([$offset, $size]);
$posts = $stmt->fetchAll(PDO::FETCH_ASSOC);

if ($_SERVER['HTTP_X_REQUESTED_WITH'] === 'XMLHttpRequest') {
    // AJAX 請求:只回傳磚塊 HTML 片段
    foreach ($posts as $post) {
        include "partials/_post_card.php"; // 渲染單張卡片
    }
    exit;
}
// 非 AJAX:渲染完整頁面(含 container、sentinel 等)
include "layout.php";
?>

響應式斷點調整

// 根據視窗寬度動態調整 columnWidth
function updateMasonryColumns() {
    const width = $container.width();
    let colWidth;
    if (width < 600) colWidth = ".box"; // 1 欄
    else if (width < 900) colWidth = 280; // 2 欄
    else colWidth = 300; // 3 欄

    $container.masonry("option", {columnWidth: colWidth}).masonry("layout");
}
$(window).on("resize", debounce(updateMasonryColumns, 200));

常見坑點與解決

  • 圖片未載入導致佈局重疊: 必須用 imagesLoaded 回調後再 masonry(),新增項同理。
  • 動態內容高度變化: 圖片載入、字體載入、折疊面板展開後呼叫 $container.masonry("layout")。
  • 銷毀實例: 頁面切換時 $container.masonry("destroy") 避免記憶體洩漏。
copyright © 萬盛學電腦網 all rights reserved