jQuery全屏滚动插件fullPage.js中文帮助文档API

jQuery全屏滚动插件fullPage.js中文帮助文档API

 

发现了一个fullPage.js插件，于是百度了一下，还就是这个插件的作用，其实有很多网站都做了全屏滚动的特效，效果也很好看，今天就给大家说说fullPage.js的使用方法和设置。

 

简介

fullPage.js是一个基于jQuery的全屏滚动插件，它能够很方便、很轻松的制作出全屏网站

 

主要功能

支持鼠标滚动

支持前进后退和键盘控制

多个回调函数

支持手机、平板触摸事件

支持 CSS3 动画

支持窗口缩放

窗口缩放时自动调整

可设置滚动宽度、背景颜色、滚动速度、循环选项、回调、文本对齐方式等等

兼容性

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

 

使用方法

1、引入文件

 <linkrel="stylesheet"href="css/jquery.fullPage.css">
 <scriptsrc="js/jquery.min.js"></script>
 <scriptsrc="js/jquery-ui.min.js"></script>
 <scriptsrc="js/jquery.fullPage.js"></script>

2、HTML

   1.整版的幻灯片放映

 <divid="fullpage">
 <divclass="section">Some section</div>
 <divclass="section">Some section</div>
 <divclass="section">Some section</div>
 <divclass="section">Some section</div>
 </div>

   2.如果你想定义一个不同的出发点，而不是一段或一部分的第一个幻灯片，只需添加active section类，并放在你想加载幻灯片位置前，

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

   3.为了在一个幻灯片区域内创造另外横向幻灯片，每个幻灯片将定义另一个div

 <divclass="section">
 <divclass="slide"> Slide 1 </div>
 <divclass="slide"> Slide 2 </div>
 <divclass="slide"> Slide 3 </div>
 <divclass="slide"> Slide 4 </div>
 </div>

You can see a fully working example of the
HTML structure in the demoPage.html file.

 

3、JavaScript

 $(document).ready(function(){
 $.fn.fullpage({
 slidesColor:[''#1bbc9b'',''#4BBFC3'',''#7BAABE'',''#f90''],
 anchors:[''page1'',''page2'',''page3'',''page4'']
 });
 });

经测试，最好至少有 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个参数