A simple and easy to use plugin to create fullscreen scrolling websites. (also known as single page websites)
It allows to create fullscren scrolling websites as well as adding some landscape sliders inside the sections of the site.
- Living demo
- [Temporal Website] (http://alvarotrigo.com/blog/fullpage-jquery-plugin-for-fullscreen-scrolling-websites/)
The plugin is in its first version and will keep improving with the time. Suggestion will be more than welcome, not only for requisites requests but also for coding improvements.
Let's make of this a great plugin to make the world easier!
Working under all modern browsers as well as old ones such as IE8, Opera 12...
As you can see in the example.html
file, you will need to include the javascript file jquery.fullPage.js
(or the minified version jquery.fullPage.min.js
) and the css file jquery.fullPage.css
of the plugin as well as jQuery library (and the jQuery UI library in case you want to use easing effects. (active by default))
###Including files:
<link rel="stylesheet" type="text/css" href="jquery.fullPage.css" />
<script src="http://ajax.googleapis.com/ajax/libs/jquery/1.8.3/jquery.min.js"></script>
<script src="http://ajax.googleapis.com/ajax/libs/jqueryui/1.9.1/jquery-ui.min.js"></script>
<!-- This line is needed in case of setting the plugin
option `scrollOverflow` to `true` -->
<script type="text/javascript" src="vendors/jquery.slimscroll.min.js"></script>
<script type="text/javascript" src="jquery.fullPage.js"></script>
###Required HTML structure
Each section will be defined with a div
containing the section
class.
The active section by default will be the first section, which is taken as the home page.
<div class="section">WHATEVER</div>
<div class="section">WHATEVER</div>
<div class="section">WHATEVER</div>
<div class="section">WHATEVER</div>
In order to create a landscape slider within a section, each slide will be defined with another div
:
<div class="section">
<div class="slide"> Slide 1 </div>
<div class="slide"> Slide 2 </div>
<div class="slide"> Slide 3 </div>
<div class="slide"> Slide 4 </div>
</div>
You can see a full example of the HTML structure in the example.html
file.
###Initialization
Then, you will only need to call the plugin inside $(document).ready
function:
$(document).ready(function() {
$.fn.fullpage();
});
In order to create links to certain slides inside a section, you could do it by just adding two attributes to any element:
- class="toSlide"
- data-index="3" (or whatever slide number you want to link)
For example:
<span class="toSlide" data-index="3">Click here to go to slide 3</span>
To create links between sections, you could use the menu
option and make use of anchor links (#) as explained below in the options section.
-
verticalCentered
: (defaulttrue
) Vertically centering of the content within sections. -
resize
: (defaulttrue
) Whether you want to resize the text when the window is resized. -
scrollingSpeed
: (default700
) Speed in miliseconds for the scrolling transitions. -
slidesColor
:(defaultnone
) Define the CSSbackground-color
property for each section: Example:
$.fn.fullpage({
slidesColor: ['#f2f2f2', '#4BBFC3', '#7BAABE', 'whitesmoke', '#000'],
});
-
easing
: (defaulteaseInQuart
) Defines the transition effect to use for the vertical scrolling. It requieres jQuery UI library in case of using some of its transitions. Other library could be used instead. -
loopTop
: (defaultfalse
) Defines whether scrolling up in the first section should scroll to the last one or not. -
loopBottom
: (defaultfalse
) Defines whether scrolling down in the last section should scroll to the first one or not. -
autoScrolling
: (defaulttrue
) Defines whether to use the "automatic" scrolling or the "normal" one. It also has influence on the way the sections fit the browser/device window in tablets and mobile phones. -
menu
: (defaultfalse
) A selector can be used to specify the menu to link with the slides. This way the scrolling of the slides will activate the corresponding element in the menu using the classactive
. This won't generate a menu but will just add theactive
class to the element in the given menu with the corresponding anchor link. In order to link the elements of the menu with the slides, an HTML 5 data-tag (data-menuanchor
) will be needed to use with the same anchor links as used within the sections. Example:
<ul id="myMenu">
<li data-menuanchor="firstPage" class="active"><a href="#firstPage">First section</a></li>
<li data-menuanchor="secondPage"><a href="#secondPage">Second section</a></li>
<li data-menuanchor="thirdPage"><a href="#thirdPage">Third section</a></li>
<li data-menuanchor="fourthPage"><a href="#fourthPage">Fourth section</a></li>
</ul>
$.fn.fullpage({
anchors: ['firstPage', 'secondPage', 'thirdPage', 'fourthPage', 'lastPage'],
menu: '#myMenu'
});
scrollOverflow
: (defaultfalse
) defines whether or not to create an scroll for the section in case its content is bigger than the height of it. In case of setting it totrue
, it requieres the vendor pluginjquery.slimscroll.min
and it should be loaded before fullPaje.js plugin. For example:
<script type="text/javascript" src="vendors/jquery.slimscroll.min.js"></script>
<script type="text/javascript" src="jquery.fullPage.js"></script>
Scrolls one slide up:
$.fn.fullpage.moveSlideUp();
Scrolls one slide down:
$.fn.fullpage.moveSlideDown();
Scrolls the page to the given slide anchor name or to the given index.
/*Scrolling to the section with the anchor link `firstSlide` */
$.fn.fullpage.moveToSlide('#firstSlide');
/*Scrolling to the 3rd section in the site*/
$.fn.fullpage.moveToSlide(3);
Defines the way the page scrolling behaves. If it is set to true
, it will use the "automatic" scrolling,
otherwise, it will use the "manual" or "normal" scrolling of the site. Be careful when combining this option with
scrollOverflow
set to true, as it might be difficult to scroll using the mouse wheel or the trackpad when the section
is scrollable.
$.fn.fullpage.setAutoScrolling('false');
afterLoad (anchorLink
, index
)
Callback fired once the sections has been loaded, once the scrolling has ended.
Parameters:
anchorLink
: anchorLink corresponding to the section.index
: index of the section. Starting from 1.
In case of not having anchorLinks defined in the plugin the index
parameter would be the only one to use.
Example:
$.fn.fullpage({
anchors: ['firstPage', 'secondPage', 'thirdPage', 'fourthPage', 'lastPage'],
afterLoad: function(anchorLink, index){
//using index
if(index == '3'){
alert("Section 3 ended loading");
}
//using anchorLink
if(anchorLink == 'secondSlide'){
alert("Section 2 ended loading");
}
}
});
afterRender () This callback is fired just after the structure of the page is generated. This is the callback you want to use to initialize other plugins or fire any code which requieres the document to be ready. (as this plugin modifies the document DOM to create the resulting structure)
Example:
$.fn.fullpage({
afterRender: function(){
alert("The resulting DOM stucture is ready");
}
});
(The MIT License)
Copyright (c) 2013 Alvaro Trigo <[email protected]>
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.