跳转到内容

固钉 Affix

基本用法,不设置固定位置时,当页面滚动元素不可见时,元素固定在页面最顶部。

当页面滚动或浏览器窗口改变时,元素向下滚动到距底部一定距离时固定。

target 设置需要监听其滚动事件的元素,默认为 window。 target 指定为非 window 容器时,可能会出现 target外层元素滚动,固钉元素跑出滚动容器的问题。这个时候可以通过传入targetContainer传入target外层的滚动元素。Affix 会监听该元素的滚动事件来实时更新滚钉元素的位置。 当然您也可以在业务代码中自己监听target外层滚动元素的 scroll 事件,并调用 updatePosition 去更新固钉的位置。

当固定状态发生改变时,会触发事件。

当页面滚动或浏览器窗口改变时,元素向上滚动到距顶部一定距离时固定。

参数名描述类型默认值
offset-top距离窗口顶部达到指定偏移量后触发number0
offset-bottom距离窗口底部达到指定偏移量后触发number-
target滚动容器,默认是 windowstring | HTMLElement | Window-
target-containertarget的外层滚动元素,默认是 windowAffix 将会监听该元素的滚动事件,并实时更新固钉的位置。主要是为了解决 target 属性指定为非 window 元素时,如果外层元素滚动,可能会导致固钉跑出容器问题string | HTMLElement | Window-
事件名描述参数
change固定状态发生改变时触发fixed: boolean
方法名描述参数返回值
updatePosition更新位置--