FullPage.js 深度指南

2026-01-16 10:29:15作者：范垣楠Rhoda

1. 项目介绍

FullPage.js 是一款流行的 JavaScript 库，用于创建全屏滚动网站。它提供了丰富的功能，包括自动滚动、导航条、滚动指示器以及响应式设计等。这款库使得开发者能够轻松地构建出视觉效果震撼且交互性强的网页。

2. 项目快速启动

安装

在你的项目中，可以通过 npm 或 CDN 引入 FullPage.js：

npm

npm install fullpage.js

CDN

<script src="https://cdn.jsdelivr.net/npm/fullpage.js@latest/dist/fullpage.min.js"></script>

基本配置

在 HTML 中添加基本结构，并初始化插件：

<!DOCTYPE html>
<html lang="zh">
<head>
    <meta charset="UTF-8">
    <title>FullPage.js 示例</title>
    <style>
        /* 自定义样式 */
        .section {
            text-align: center;
            padding: 200px 0;
        }
    </style>
</head>
<body>

<div id="fullpage">
    <div class="section">第一页</div>
    <div class="section">第二页</div>
    <!-- 添加更多页面 -->
</div>

<script>
document.addEventListener('DOMContentLoaded', function () {
    new fullpage('#fullpage', {
        // 配置项
    });
});
</script>
</body>
</html>

3. 应用案例和最佳实践

使用数据锚点（Data Anchor）
使用 data-anchor 属性定义部分的锚点，确保没有与页面内其他 ID 或者 IE 的 NAME 元素相同的值。
响应式设计
设置 responsiveWidth 和 responsiveHeight 参数以在特定屏幕尺寸下切换到普通滚动模式。
懒加载
对于图像、视频和音频元素，可以使用懒加载，只有当它们进入视口时才加载。
滚动事件监听
利用 FullPage.js 的回调函数，如 onLeave, afterLoad, afterRender 等来实现动态效果或更新状态。

4. 典型生态项目

Vue.js 插件
vue-fullpage - Vue.js 社区提供的 FullPage.js 封装组件。
React.js 包装器
react-fullpage - 专为 React 设计的 FullPage.js 包装器。
WordPress 插件
提供了适用于 Gutenberg 编辑器和 Elementor 的 WordPress 插件，便于在 WordPress 网站上集成 FullPage.js 效果。