section-scroll.js|可生成垂直整页滚动导航的jQuery插件

当前位置:主页 > jQuery库 > 布局和界面 > section-scroll.js|可生成垂直整页滚动导航的jQuery插件
section-scroll.js|可生成垂直整页滚动导航的jQuery插件
分享:

    插件介绍

    section-scroll.js是一款可以自动生成垂直整页滚动导航的jQuery插件。通过点击圆点导航按钮可以在各个section之间平滑的滚动。该插件使用简单,非常实用。

    浏览器兼容性

    浏览器兼容性
    时间:01-21
    阅读:
简要教程

section-scroll.js是一款可以自动生成垂直整页滚动导航的jQuery插件。通过点击圆点导航按钮可以在各个section之间平滑的滚动。该插件使用简单,非常实用。

使用方法

下载压缩包,在页面中引入jquery,jquery.section-scroll.js和section-scroll.css文件。如果你需要制作带easing效果的动画过渡效果,可以引入jquery.easing.1.3.js文件。

<link href="css/section-scroll.css" rel="stylesheet" />
<script src="js/jquery.min.js"></script>
<script src="js/jquery.easing.1.3.js"></script> 
<script src="js/jquery.section-scroll.js"></script> 
  
HTML结构

该插件会将每一个<section>元素作为一个段落,每一个滚动导航按钮会对应一个段落。

<div class="scrollable-section" data-section-title="段落-1"></div> 
<div class="scrollable-section" data-section-title="段落-2"></div> 
<div class="scrollable-section" data-section-title="段落-3"></div>   
  

其中,scrollable-section是你想要加入到滚动导航中的<section>data-section-title插件会将该属性作为导航菜单项的标题。

初始化插件

在页面DOM元素加载完毕之后,可以通过下面的方法来初始化section-scroll.js插件。

<script type="text/javascript"> 
  $(document).ready(function () { 
      $('body').sectionScroll(); 
  }) 
</script>   
  

配置参数

section-scroll.js插件的默认配置参数是:

bulletsClass: 'section-bullets',
sectionsClass: 'scrollable-section',
scrollDuration: 1000,
titles: true,
topOffset: 0,
easing: ''    
  
参数 类型 描述
bulletsClass string 设置圆点导航菜单的class类
sectionsClass string 默认插件会查找class为scrollable-section<section>元素作为滚动的段落,通过该参数可以改变这个class
scrollDuration int 从一个section滚动到另一个section的持续时间
titles boolean 设置为false可以在导航中隐藏标题
topOffset int 例如设置该值为100会在滚动到section时,section距离页面顶部100像素
easing string 默认情况下该插件不提供easing效果,你可以引入http://gsgd.co.uk/sandbox/jquery/easing/插件之后在使用该参数来设置easing效果。easing的取值可以查看http://easings.net/

事件

  • section-reached:当每一个section滚动进入屏幕时都会触发该事件。
$('body').on('section-reached', function(){ 
    console.log('section-reached'); 
})  

小技巧

该插件也可以通过变量activeSection来访问被激活的section。例如:

$('body').on('section-reached', function(){
    var section_title = $('body').sectionScroll.activeSection.data('section-title');
    alert(section_title);
})  

再看下面的例子:

<section class="scrollable-section" data-short-description="We love coding"></section>  

现在我们可以获取section的标题信息,打印在div中。

$('body').on('section-reached', function(){
    var short_description = $('.body').sectionScroll.activeSection.data('short-description');
    $('div').html(short_description);
    // 我们还可以将激活section的背景色进行修改
    $('body').sectionScroll.activeSection.css('background-color', '#000'); 
})  

section-scroll插件的github地址为:https://github.com/m-danish-iqbal/section-scroll