FullPage.js 基于 jQuery 的全屏滚动插件

Question

如今我们经常能见到全屏网站，尤其是国外网站。这些网站用几幅很大的图片或色块做背景，再添加一些简单的内容，显得格外的高端大气上档次。FullPage.js 是一个基于 jQuery 的全屏滚动插件，它能够很方便、很轻松的制作出全屏网站。

主要功能

• 支持鼠标滚动
• 支持前进后退和键盘控制
• 多个回调函数
• 支持手机、平板触摸事件
• 支持 CSS3 动画
• 支持窗口缩放
• 窗口缩放时自动调整
• 可设置滚动宽度、背景颜色、滚动速度、循环选项、回调、文本对齐方式等等

兼容性

fullPage.js 支持 IE8+ 及其他现代浏览器。

使用方法

1、引入文件

<link rel="stylesheet" href="css/jquery.fullPage.css">
<script src="js/jquery.min.js"></script>
<script src="js/jquery-ui.min.js"></script>
<script src="js/jquery.fullPage.js"></script>

2、HTML

<div id="fullpage">
    <div class="section">第一屏</div>
    <div class="section">第二屏</div>
    <div class="section">
        <div class="slide">第三屏的第一屏</div>
        <div class="slide">第三屏的第二屏</div>
        <div class="slide">第三屏的第三屏</div>
        <div class="slide">第三屏的第四屏</div>
    </div>
    <div class="section">第四屏</div>
</div>

3、JavaScript

$(function(){
    $('#fullpage').fullpage({
        'verticalCentered': false,
        'css3': true,
        'sectionsColor': ['#254875', '#00FF00', '#254587', '#695684'],
        anchors: ['page1', 'page2', 'page3', 'page4'],
        'navigation': true,
        'navigationPosition': 'right',
        'navigationTooltips': ['fullPage.js', 'Powerful', 'Amazing', 'Simple']
    })
})

经测试，最好至少有 anchors 这个参数，否则在火狐浏览器中，第一次滚动可能会直接滚到网页的底部，非常影响用户体验。

可选配置

1、选项

选项	类型	默认值	说明
verticalCentered	字符串	true	内容是否垂直居中
resize	布尔值	false	字体是否随着窗口缩放而缩放
slidesColor	函数	无	设置背景颜色
anchors	数组	无	定义锚链接
scrollingSpeed	整数	700	滚动速度，单位为毫秒
easing	字符串	easeInQuart	滚动动画方式
menu	布尔值	false	绑定菜单，设定的相关属性与 anchors 的值对应后，菜单可以控制滚动
navigation	布尔值	false	是否显示项目导航
navigationPosition	字符串	right	项目导航的位置，可选 left 或 right
navigationColor	字符串	#000	项目导航的颜色
navigationTooltips	数组	空	项目导航的 tip
slidesNavigation	布尔值	false	是否显示左右滑块的项目导航
slidesNavPosition	字符串	bottom	左右滑块的项目导航的位置，可选 top 或 bottom
controlArrowColor	字符串	#fff	左右滑块的箭头的背景颜色
loopBottom	布尔值	false	滚动到最底部后是否滚回顶部
loopTop	布尔值	false	滚动到最顶部后是否滚底部
loopHorizontal	布尔值	true	左右滑块是否循环滑动
autoScrolling	布尔值	true	是否使用插件的滚动方式，如果选择 false，则会出现浏览器自带的滚动条
scrollOverflow	布尔值	false	内容超过满屏后是否显示滚动条
css3	布尔值	false	是否使用 CSS3 transforms 滚动
paddingTop	字符串	0	与顶部的距离
paddingBottom	字符串	0	与底部距离
fixedElements	字符串	无
normalScrollElements		无
keyboardScrolling	布尔值	true	是否使用键盘方向键导航
touchSensitivity	整数	5
continuousVertical	布尔值	false	是否循环滚动，与 loopTop 及 loopBottom 不兼容
animateAnchor	布尔值	true
normalScrollElementTouchThreshold	整数	5

2、方法

名称	说明
moveSectionUp()	向上滚动
moveSectionDown()	向下滚动
moveTo(section, slide)	滚动到
moveSlideRight()	slide 向右滚动
moveSlideLeft()	slide 向左滚动
setAutoScrolling()	设置页面滚动方式，设置为 true 时自动滚动
setAllowScrolling()	添加或删除鼠标滚轮/触控板控制
setKeyboardScrolling()	添加或删除键盘方向键控制
setScrollingSpeed()	定义以毫秒为单位的滚动速度

3、回调函数

名称	说明
afterLoad	滚动到某一屏后的回调函数，接收 anchorLink 和 index 两个参数，anchorLink 是锚链接的名称，index 是序号，从1开始计算
onLeave	滚动前的回调函数，接收 index、nextIndex 和 direction 3个参数： index 是离开的“页面”的序号，从1开始计算； nextIndex 是滚动到的“页面”的序号，从1开始计算； direction 判断往上滚动还是往下滚动，值是 up 或 down。
afterRender	页面结构生成后的回调函数，或者说页面初始化完成后的回调函数
afterSlideLoad	滚动到某一水平滑块后的回调函数，与 afterLoad 类似，接收 anchorLink、index、slideIndex、direction 4个参数
onSlideLeave	某一水平滑块滚动前的回调函数，与 onLeave 类似，接收 anchorLink、index、slideIndex、direction 4个参数

自定义Section高度

很多用户留言说无法自定义底部Footer的高度，我也查阅了很多资料，都没有发现方法，但是无意间看到一个Fullpage的示例，实现自定义底部高度的方法，而且是不算在滑动的Section里面，在需 要自定义高度的DIV里面，只需要给Section添加 .fp-auto-height 类就可以实现自定义高度。

相关链接

• 官网地址：http://alvarotrigo.com/fullPage/
• GitHub 地址：https://github.com/alvarotrigo/fullPage.js
• 中文帮助文档：https://www.wenjiangs.com/docs/fullpage-doc

Answer 1

afterSlideLoad 用于判断滚动到某个幻灯片的回调函数，用法如下：

$('#fullpage').fullpage({
	anchors: ['firstPage', 'secondPage', 'thirdPage', 'fourthPage', 'lastPage'],
	afterSlideLoad: function( anchorLink, index, slideAnchor, slideIndex){
		var loadedSlide = $(this);
		//first slide of the second section
		if(anchorLink == 'secondPage' && slideIndex == 1){
			alert("First slide loaded");
		}
		//second slide of the second section (supposing #secondSlide is the
		//anchor for the second slide
		if(index == 2 && slideIndex == 'secondSlide'){
			alert("Second slide loaded");
		}
	}
});

Answer 2

afterSlideLoad 这个回调函数怎么用？可以看一下个例子

Answer 3

图片太大会是个问题，你可以考虑使用 background-size 属性把图片等比例缩放。当值设置为 cover 的时候，就可以以最短的一边为准，等比例缩放背景图。

Answer 4

有个问题，图片是1920px*1080px的，在小屏幕中会切掉一部分内容，我在想能不能做到等比例缩放呢？

Answer 5

当鼠标划入的时候，使用setAllowScrolling(false)方法取消掉fullpage的鼠标滑轮监听。当鼠标滑出的时候，重新添加监听器。

$('#demo').mouseover(function(){
	$.fn.fullpage.setAllowScrolling(false);
}).mouseout(function(){
	$.fn.fullpage.setAllowScrolling(true);
})

Answer 6

用什么方法能使滑轮事件失效？

Answer 7

针对你的问题：
1、anchor可以为数字，这个参数只是定义锚链接的name。
2、超出部分不能显示滚动条的问题，请参见这条评论。
3、这个插件监听页面内的鼠标滑轮事件，如果想其他的内容区域不受控制，可以给这个内容区域添加一个mouseover的监听器，判断鼠标是否在这个内容区域内。

Answer 8

我的页面分为左右2个div,左边的层展示图片，右边的层则显示对应的评论，尝试用这个插件后发现以下问题：
1.anchor参数不能为纯数字，否则滚动会出错。
2.评论所在的这个层设置了css为overflow-y:auto，当评论内容很多超出层容器的时候，滚动条会出现，但却是灰色的没有滑块，无法滚动。
3.我只想要左边的图片层滚动，不需要右边的评论层也跟着滚动，但是现在是无论鼠标是在图片层还是评论层，都会触发滚动事件。

Answer 9

没有选择元素，fullPage 不知道给哪个元素添加这个效果。

Answer 10

fullpage 插件我引用本地的 js 却不起作用，是什么原因呢？
报的错是fullPage: Error! Fullpage.js needs to be initialized with a selector. For example: $(‘#myContainer’).fullpage();

Answer 11

引用 jquery.slimscroll.min.js 设置 scrollOverflow 为 true，如果内容超出了屏幕，就会自动在右边出现拖动滑条。

Answer 12

前面两屏使用fullpage完成刷屏，最后一屏使用fullpage，完成刷屏，但是最后一屏会剩下很多东西，一屏显示不完，这就需要使用鼠标滚动完成浏览，求指点怎么做