全屏滚动插件fullPage.js

效果效果
本文介绍使用fullPage.js插件可轻易创建全屏滚动网站。很多网站只有一个首页，它是由多个可以滚动的全屏内容组成，使用鼠标滚动或方向键可控制滚屏，支持CSS3动画和手机触屏，效果非常高大上。
使用方法
包含文件

<link rel="stylesheet" type="text/css" href="fullpage.css" />

<!-- 以下行是可选的。 只有在使用选项css3:false，并且您希望使用其他缓动效果，而非“linear”、“swing”或“easeInOutCubic”时才有必要。 -->
<script src="vendors/easings.min.js"></script>

<!-- 以下行仅在使用选项scrollOverflow:true的情况下是必需的 -->
<script type="text/javascript" src="vendors/scrolloverflow.min.js"></script>

<script type="text/javascript" src="fullpage.js"></script>

如果您愿意，可以使用bower或npm安装fullPage.js：

// 使用bower
bower install fullpage.js

// 使用npm
npm install fullpage.js

HTML结构
HTML文件中的首行HTML代码必须使用HTML DOCTYPE 声明，否则可能会遇到代码段高度问题。HTML 5 doctype中的示例：

<!DOCTYPE html>。
<div id="fullpage">
    <div class="section">Some section</div>
    <div class="section">Some section</div>
    <div class="section">Some section</div>
    <div class="section">Some section</div>
</div>

每个代码段定义为包含.section的元素。第一个代码段作为第一屏，是默认激活。代码段应被包含在(即<div id="fullpage"> )父元素中。注意，父元素不能是body元素。

如果你想定义一个与众不同的起始页面，而不是原始第一段或第一个滑动页，只需将.active类添加到你想首先载入的段或滑动页。

<div class="section active">Some section</div>

Javascript
用原生Javascript初始化，只需要在关闭标签之前调用fullPage.js。

new fullpage('#fullpage', {
    //options here
    autoScrolling:true,
    scrollHorizontally: true
});
//methods
fullpage_api.setAllowScrolling(false);

也可以使用jQuery进行初始化，前提需要先引用jQuery库。

$(document).ready(function() {
    $('#fullpage').fullpage({
        //options here
        autoScrolling:true,
        scrollHorizontally: true
    });

    //methods
    $.fn.fullpage.setAllowScrolling(false);
});

功能选项
所有选项设置的更复杂的初始化如下所示：

var myFullpage = new fullpage('#fullpage', {
    //导航
    menu: '#menu',  //绑定菜单，设定的相关属性与 anchors 的值对应后，菜单可以控制滚动
    lockAnchors: false, //(默认为false)确定URL中的锚是否在库中完全有效。 您仍然可以在函数和回调内部使用锚，但是它们在滚动网站时不起任何作用。 如果你想在URL中使用锚点来将fullPage.js和其他插件结合起来，那就很有用。
    anchors:['firstPage', 'secondPage'], //定义要在每个部分的URL上显示的锚链接(#example)。 锚点的值应该是独一无二的。 数组中的锚的位置将限定锚被应用于哪些部分。
    navigation: false, //如果设置为true，则会显示一个由小圆圈组成的导航栏
    navigationPosition: 'right', //(默认none)可以设置为left或right，并定义导航栏显示的位置(如果使用的话)
    navigationTooltips: ['firstSlide', 'secondSlide'], //(默认为[])定义要使用导航圈的工具提示。 如果您愿意，也可以在每个部分中使用属性data-tooltip来定义它们
    showActiveTooltip: false, //显示垂直导航中主动查看节的持久工具提示
    slidesNavigation: false, //如果设置为true，则会显示一个导航栏，该导航栏由站点上每个横向滑块的小圆圈组成。
    slidesNavPosition: 'bottom', //定义滑块的横向导航栏的位置。 值为top和bottom。

    //滚动
    css3: true, //是否使用 CSS3 transforms 滚动
    scrollingSpeed: 700, //滚动速度，单位为毫秒
    autoScrolling: true, //是否使用插件的滚动方式，如果选择 false，则会出现浏览器自带的滚动条
    fitToSection: true, //确定是否section放入视窗中
    fitToSectionDelay: 1000, //如果fitToSection设置为true，则延迟 以毫秒为单位
    scrollBar: false, //确定是否使用站点的滚动条。 在使用滚动条的情况下，autoScrolling功能仍将按预期工作。 用户也可以使用滚动条自由滚动网站，当滚动完成时，fullPage.js将适配屏幕上的部分。
    easing: 'easeInOutCubic', //定义用于垂直和水平滚动的过渡效果。
    easingcss3: 'ease', //定义在使用css3：true的情况下使用的过渡效果。
    loopBottom: false, //滚动到最底部后是否滚回顶部
    loopTop: false, //滚动到最顶部后是否滚底部
    loopHorizontal: true, //定义水平滑块是否在到达上一张或上一张幻灯片后循环
    continuousVertical: false, //是否循环滚动，与 loopTop 及 loopBottom 不兼容
    
    normalScrollElements: '#element1, .element2', //如果你想在滚动某些元素时避免自动滚动，这是你需要使用的选项
    scrollOverflow: false, //内容超过满屏后是否显示滚动条
    touchSensitivity: 15, //定义浏览器窗口宽度/高度的百分比，以及滑动到下一个节/幻灯片必须测量的距离
    normalScrollElementTouchThreshold: 5, //定义html节点树的跳数阈值Fullpage将测试normalScrollElements是否匹配，以允许在触摸设备上的div的滚动功能。
    bigSectionsDestination: null, //定义如何滚动到比视口大的部分。 默认情况下，如果您来自目的地上方的部分，fullPage.js将滚动到顶部，如果您来自目的地之下的部分，则会滚动到底部。 可能的值是top，bottom，null。

    //可访问
    keyboardScrolling: true, //定义是否可以使用键盘浏览内容
    animateAnchor: true, //定义给定锚点(＃)的站点的负载是否会随着动画滚动到其目的地或直接加载给定部分
    recordHistory: true, //定义是否将网站的状态推送到浏览器的历史记录。 设置为true时，网站的每个部分/幻灯片将作为新页面，浏览器的后退和前进按钮将滚动部分/幻灯片以达到网站的上一个或下一个状态。 当设置为false时，URL将保持更改，但不会影响浏览器的历史记录。 使用autoScrolling：false时，该选项会自动关闭。

    //设计
    controlArrows: true, //确定是否将幻灯片的控制箭头向右或向左移动
    verticalCentered: true, //在段落内部垂直居中。 当设置为true时，您的代码将被库包装。可考虑使用委托或在afterRender回调中加载其他脚本
    sectionsColor : ['#ccc', '#fff'], //为每个部分定义CSSbackground-color属性
    paddingTop: '3em', //与顶部的距离
    paddingBottom: '10px', //与底部距离
    fixedElements: '#header, .footer', //定义当使用css3选项保持固定时，哪些元素将从插件的滚动结构中移除。 它需要一个字符串与这些元素的Javascript选择器。 (例如：fixedElements：'＃element1，.element2')
    responsiveWidth: 0, //一个正常的滚动(autoScrolling：false)将在定义的宽度下以像素为单位使用。 如果用户希望将自己的响应式CSS用于身体标记，则会将fp-responsive类添加到身体标记中。 例如，如果设置为900，则每当浏览器的宽度小于900时，插件将像正常站点一样滚动。
    responsiveHeight: 0, //一个正常的滚动(autoScrolling：false)将在定义的高度下以像素为单位使用。 如果用户希望将自己的响应式CSS用于身体标记，则会将fp-responsive类添加到身体标记中。 例如，如果设置为900，则每当浏览器的高度小于900时，插件将像正常站点一样滚动。

    //自定义选择器
    sectionSelector: '.section', //定义用于插件部分的Javascript选择器。 有时可能需要更改，以避免与使用与fullpage.js相同的选择器的其他插件的问题。
    slideSelector: '.slide', //定义用于插件幻灯片的Javascript选择器。 有时可能需要更改，以避免与使用与fullpage.js相同的选择器的其他插件的问题。

    lazyLoading: true, //延迟加载默认是激活的，这意味着它会延迟加载包含属性data-src的任何媒体元素

    //事件
    onLeave: function(index, nextIndex, direction){},//滚动前的回调函数，接收 index、nextIndex 和 direction 3个参数：index 是离开的“页面”的序号，从1开始计算；nextIndex 是滚动到的“页面”的序号，从1开始计算；direction 判断往上滚动还是往下滚动，值是 up 或 down。
    afterLoad: function(origin, destination, direction){}, //滚动结束之后，一旦加载了节，就会触发回调。
    afterRender: function(){}, //这个回调在页面结构生成后立即被触发。 这是您要用来初始化其他插件的回调函数，或者触发任何需要文档准备就绪的代码
    afterResize: function(width, height){},//调整浏览器窗口大小后，会触发此回调。
    afterResponsive: function(isResponsive){}, //在fullpage.js从正常模式变为响应模式或从响应模式变为正常模式之后，此回调将被触发
    afterSlideLoad: function(section, origin, destination, direction){}, //滚动结束后，加载一个section的幻灯片后触发回调。
    onSlideLeave: function(section, origin, destination, direction){} //一旦用户离开幻灯片转到另一个幻灯片，就会触发此回调。返回false将在移动发生之前取消移动。
});
方法

moveSectionUp() 向上滚动

moveSectionDown() 向下滚动

moveTo(section, slide) 滚动到

moveSlideRight() slide 向右滚动

moveSlideLeft() slide 向左滚动

setAutoScrolling() 设置页面滚动方式，设置为 true 时自动滚动

setAllowScrolling() 添加或删除鼠标滚轮/触控板控制

setKeyboardScrolling() 添加或删除键盘方向键控制

setScrollingSpeed() 定义以毫秒为单位的滚动速度

其他
延迟加载
fullPage.js提供了一种延迟加载图像、视频和音频元素的方式，这样它们不会减慢网站的加载速度，也不会浪费数据传输。当使用延迟加载时，所有这些元素只有在进入视口时才会加载。要启用延迟加载，您只需将src属性更改为data-src，如下所示：

<img data-src="image.png">
<video>
    <source data-src="video.webm" type="video/webm" />
    <source data-src="video.mp4" type="video/mp4" />
</video>

如果您已经使用另一个使用data-src的延迟加载解决方案，则可以通过设置 lazyLoading: false选项来禁用fullPage.js延迟加载。

自动播放
对于视频或音频使用属性 autoplay，或者对于youtube iframe使用参数autoplay=1将使得在加载页面时播放媒体元素。在段落/幻灯片载入使用而不是属性data-autoplay播放。例如：

<audio data-autoplay>
    <source src="http://metakoncept.hr/horse.ogg" type="audio/ogg">
</audio>

暂停
嵌入式HTML5<video>/<audio>和Youtube iframe在离开某个段落或幻灯片时自动暂停。可以通过使用属性data-keepplaying来禁用。例如：

<audio data-keepplaying>
    <source src="http://metakoncept.hr/horse.ogg" type="audio/ogg">
</audio>

此外，fullpage.js还可以使用扩展插件，更多详情请查看fullpage.js项目官网：https://github.com/alvarotrigo/fullPage.js.

全屏滚动插件fullPage.js

相关阅读

相关文章

相关问答

相关文档