hc-sticky是一款jquery页面滚动固定元素插件。该插件可以跨浏览器使用,具有在页面滚动时将指定元素固定在窗口上的功能。该页面滚动固定元素插件有js版本和jquery版本。

安装

可以通过npm或bower来安装hc-sticky插件。

npm: npm install --save hc-sticky
bower: bower install --save hc-sticky                  
                

使用方法

在页面中引入jQuery和hc-sticky.js文件。

<script src="js/jquery.min.js"></script>
<script src="js/hc-sticky.js"></script>
                
初始化插件

该页面滚动固定元素插件分js版本和jQuery版本,初始化方法分别如下:

js版本:

var Sticky = new hcSticky('#element', {
  stickTo: '#content'
});      
                

jQuery版本:

jQuery(document).ready(function($) {
  $('#element').hcSticky({
    stickTo: '#content'
  });
});              
                

配置参数

该jquery页面滚动固定元素插件的可用配置参数有:

参数 默认值 类型 描述
top 0 int 目标元素固定在距离窗口顶部多少距离。
bottom 0 int 目标元素固定在距离窗口底部多少距离。
innerTop 0 int 固定元素内部距离元素顶部的距离。
innerSticker null string / element object 在固定元素内部的元素,优先级比nnerTop高。
bottomEnd 0 int 参考元素底部停止的距离。
stickTo null(父元素) string / element object 固定元素附着的容器。
followScroll true boolean 如果设置为false,在固定元素的高度大于窗口时将不会随着窗口滚动。
stickyClass 'sticky' string 添加到滚动元素上的class类。
queries null object 包含响应式断点的对象。
onStart null function 当元素被固定时的回调函数。
onStop null function 当元素停止跟随滚动时的回调函数。
onBeforeResize null function 当固定元素尺寸被改变前触发。
onResize null function 当固定元素尺寸被改变时触发。
resizeDebounce 100 int Limit the rate at which the HC Sticky can fire on window resize.

方法

该jquery页面滚动固定元素插件的可用方法有:

方法 接收值 描述
options string 返回当前的配置。
update object 更新配置参数。
reinit N/A 重新计算固定元素的尺寸和位置。
detach N/A 将HC-Sticky从元素上分离。
attach N/A 将HC-Sticky附着到元素上。
destroy N/A 销毁插件。

该jquery页面滚动固定元素插件的github地址为:https://github.com/somewebmedia/hc-sticky