萬盛學電腦網

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

基於 jQuery.fullPage 實現搜狐快站風格全屏滾動頁面

專案背景

「搜狐快站」早期採用全屏翻頁佈局,每屏佔滿視窗,支援滑鼠滾輪、鍵盤、觸控滑動切換。jQuery.fullPage.js(現更名為 fullpage.js)是實現此類單頁全屏滾動的經典庫,支援區塊、幻燈片、回調、響應式等豐富功能。本文提供一個最小可用示例,並說明關鍵配置項。

依賴引入

<link rel="stylesheet" href="jquery.fullPage.css" />
<script src="jquery-1.8.3.min.js"></script>
<script src="jquery-ui-1.10.3.min.js"></script> <!-- 部分版本需 UI -->
<script src="jquery.fullPage.js"></script>

HTML 結構規範

<div id="fullpage">
  <div class="section">第一屏內容</div>
  <div class="section">第二屏內容</div>
  <div class="section">
    <div class="slide">第三屏-第一張幻燈片</div>
    <div class="slide">第三屏-第二張幻燈片</div>
  </div>
  <div class="section">第四屏</div>
  <div class="section">第五屏</div>
</div>

<!-- 可選導航選單 -->
<ul id="menu">
  <li data-menuanchor="page1">首頁</li>
  <li data-menuanchor="page2">產品</li>
  <li data-menuanchor="page3">案例</li>
  <li data-menuanchor="page4">關於</li>
  <li data-menuanchor="page5">聯繫</li>
</ul>

核心初始化代碼

$(document).ready(function () {
  $('#fullpage').fullpage({
    // 視覺配置
    sectionsColor: ['#fff', '#f2f2f2', '#fff', '#f9f9f9', '#fff'],
    // 錨點連結,支援瀏覽器前進後退
    anchors: ['page1', 'page2', 'page3', 'page4', 'page5'],
    // 綁定導航選單
    menu: '#menu',
    
    // 交互行為
    navigation: true,           // 右側圓點導航
    navigationPosition: 'right',
    navigationTooltips: ['首頁', '產品', '案例', '關於', '聯繫'],
    showActiveTooltip: true,
    
    // 滾動控制
    scrollOverflow: true,       // 內容超出時區塊內滾動
    scrollingSpeed: 800,        // 切換動畫時長
    easing: 'easeInOutCubic',   // 緩動函數(需 easing 插件)
    
    // 回調
    afterLoad: function (anchorLink, index) {
      console.log('進入第 ' + index + ' 屏');
    },
    onLeave: function (index, nextIndex, direction) {
      // 返回 false 可阻止切換
    }
  });
});

進階技巧

響應式斷點

responsiveWidth: 768,  // 寬度 ≤ 768px 時自動關閉 fullPage,恢復原生滾動
responsiveHeight: 600,

動態新增/移除區塊

$.fn.fullpage.addSection('
新區塊
'); $.fn.fullpage.removeSection(3); // 移除第 3 屏

水平幻燈片控制

// 程式化切換幻燈片
$.fn.fullpage.moveSlideRight();
$.fn.fullpage.moveSlideLeft();

常見坑點與解決

  • 內容高度超出視窗:啟用 scrollOverflow: true 並引入 jquery.slimscroll.min.js 或原生 overflow:auto(v3+ 內建)。
  • 錨點導致頁面跳動:確保 anchors 值唯一且無特殊字符;若不需要 URL 錨點,設 anchors: []。
  • 行動端觸控衝突:若區塊內有 Swiper 等輪播組件,需在 onSlideLeave 中處理觸控事件傳播,或設 touchSensitivity: 5 調整靈敏度。
  • 版本差異:v2.x 為 jQuery 插件;v3+ 為純 JS 模組化版本,API 有較大變動,升級前請閱讀遷移指南。

結語

fullPage.js 以聲明式配置、豐富的回調體系與良好的行動端適配,成為全屏滾動頁面的標準化選擇。掌握其核心選項與生命週期鉤子,即可快速構建類「搜狐快站」的沉浸式單頁體驗。


📌 官方文檔:alvarotrigo.com/fullPage | GitHub:fullPage.js

copyright © 萬盛學電腦網 all rights reserved