vue-sticky组件详解
sticky简介sticky的本意是粘的,粘性的,使用其进行的布局被称为粘性布局。sticky是position属性新推出的值,属于CSS3的新特性,常用与实现吸附效果。设置了sticky布局的元素,在视图窗口时,与静态布局的表现一致。但当该元素的位置移出设置的视图范围时,其定位效果将变成fixed,并根据设置的left、top等作为其定位参数。具体效果如下,当页面滚动至下方,原本静态布局的「演职员表」将变为fixed布局,固定在页面顶部。sticky兼容性下图可见,除了IE以外,目前绝大部分浏览器都是支持sticky布局。需求背景但是实际情况并不如上图展示的那么美好,在360安全浏览器上,并不支持sticky布局,即使使用极速模式(使用chrome内核运行)也不支持。另外,笔者在网上找过相关的vue-sticky组件。但是使用起来并不是那么顺手,而且看其源码也是一头雾水,用着不踏实。所以自己写了一个,希望通过本文能将组件分享出去,也希望将本组件的原理讲清楚。让其他同学在使用的时候能更踏实一些。遇到坑也知道该怎么去填。希望能帮到大家。面向人群急于使用vue-sticky组件的同学。直接下载文件,拷贝代码即可运行。喜欢看源码,希望了解组件背后原理的同学。其实本sticky组件原理很简单,看完本文,相信你一定能把背后原理看懂。刚接触前端的同学也可以通过本文章养成看源码的习惯。打破对源码的恐惧,相信自己,其实看源码并没有想象中的那么困难组件完整源码如下<!–sticky组件–><template> <!–盒子容器–> <section ref="$box" class=“c-sticky-box” :style=“boxStyle”> <!–内容容器–> <div ref="$content" class=“content” :style=“contentStyle”> <slot></slot> </div> </section></template><script>export default { props: { top: { type: [String], default: ‘unset’, }, left: { type: [String], default: ‘unset’, }, }, data() { return { boxStyle: { position: ‘static’, top: 0, left: 0, width: ‘auto’, // 占位,为了形成数据绑定 height: ‘auto’, }, contentStyle: { position: ‘static’, top: 0, left: 0, width: ‘auto’, height: ‘auto’, }, isFixedX: false, // 是否已经设置为fixed布局,用于优化性能,防止多次设置 isFixedY: false, // 是否已经设置为fixed布局,用于优化性能,防止多次设置 isSupport: this.cssSupport(‘position’, ‘sticky’), // isSupport: false, } }, mounted() { if (!this.isSupport) { // 不支持sticky this.getContentSize() // 获取内容宽高 this.scrollHandler() // 主动触发一次位置设置操作 window.addEventListener(‘resize’, this.onResize) window.addEventListener(‘scroll’, this.scrollHandler, true) } else { this.boxStyle = { position: ‘sticky’, top: this.top, left: this.left, } } }, beforeDestroy() { if (!this.isSupport) { window.removeEventListener(‘resize’, this.onResize) window.removeEventListener(‘scroll’, this.scrollHandler, true) } }, methods: { // 判断是否支持某样式的函数 cssSupport(attr, value) { let element = document.createElement(‘div’) if (attr in element.style) { element.style[attr] = value return element.style[attr] === value } else { return false } }, // 获取dom数据 getContentSize() { // 获取内容容器宽高信息 const style = window.getComputedStyle(this.$refs.$content) // 设置盒子容器的宽高,为了后续占位 this.boxStyle.width = style.width this.boxStyle.height = style.height }, // 页面缩放重置大小时,重新计算其位置 onResize() { const { $box } = this.$refs const { contentStyle } = this const boxTop = $box.getBoundingClientRect().top const boxLeft = $box.getBoundingClientRect().left if (contentStyle.position === ‘fixed’) { contentStyle.top = this.top === ‘unset’ ? ${boxTop}px : this.top contentStyle.left = this.left === ‘unset’ ? ${boxLeft}px : this.left } }, scrollHandler() { const { $content, $box } = this.$refs const { contentStyle } = this const boxTop = $box.getBoundingClientRect().top const boxLeft = $box.getBoundingClientRect().left const contentTop = $content.getBoundingClientRect().top const contentLeft = $content.getBoundingClientRect().left if (this.top !== ‘unset’) { if (boxTop > parseInt(this.top) && this.isFixedY) { this.isFixedY = false contentStyle.position = ‘static’ } else if (boxTop < parseInt(this.top) && !this.isFixedY) { this.isFixedY = true contentStyle.position = ‘fixed’ this.onResize() } // 当位置距左位置不对时,重新设置fixed对象left的值,防止左右滚动位置不对问题 if (contentLeft !== boxLeft && this.left === ‘unset’) { this.onResize() } } if (this.left !== ‘unset’) { if (boxLeft > parseInt(this.left) && this.isFixedX) { this.isFixedX = false contentStyle.position = ‘static’ } else if (boxLeft < parseInt(this.left) && !this.isFixedX) { this.isFixedX = true contentStyle.position = ‘fixed’ this.onResize() } // 当位置距左位置不对时,重新设置fixed对象left的值,防止左右滚动位置不对问题 if (contentTop !== boxTop && this.top === ‘unset’) { this.onResize() } } }, },}</script>技术难点sticky效果需要解决这么几个问题占位问题,sticky实现原理,无非是在特定超出视图时,将内容的布局设为fixed。但将内容设置为fixed布局时,内容将脱离文档流,原本占据的空间将被释放掉,这将导致页面空了一块后其他内容发生位移。页面resize后位置问题。当使用fixed定位时,其定位将根据页面进行。若页面大小发现变化,原显示的位置可能与页面变化后的不一致。这时需要重新设置。横向滚动条问题。本质上和resize是同一个问题,需要监听scroll事件,当页面发送无相关方向的位移时,需要重新计算其位置,例如前面的sticky效果示例中设置了「演职员表」的top值,当其fixed后,滚动X轴,需要重新设置fixed的left参数。让元素始终位于页面相同位置实现思路组件有两层容器一个是内容slot的容器$content一个是内容容器$content的sticky盒子容器$box即包围关系为$sticky-box($content(slot))<section ref="$box" class=“c-sticky-box” :style=“boxStyle”> <div ref="$content" class=“content” :style=“contentStyle”> <slot></slot> </div></section>监听vue的mounted事件这时内容slot已经被渲染出来获取slot容器$content的宽高,设置到$box容器上设置$box容器宽高是为了当后续$content容器Fixed后,$box容器仍在页面中占据空间。const style = window.getComputedStyle(this.$refs.$content)this.boxStyle.width = style.widththis.boxStyle.height = style.height监听scroll事件在事件中获取容器$content在页面中的位置,并将其与预设值进行大小比较,判断$content是否应该fixed怎么便捷地获取$content在页面中的位置呢?直接使用Element.getBoundingClientRect()函数,该函数将返回{left,top}分别表示dom元素距离窗口的距离。详细可参看MDN文档const { $content, $box } = this.$refsconst { contentStyle } = thisconst boxTop = $box.getBoundingClientRect().topconst boxLeft = $box.getBoundingClientRect().leftconst contentTop = $content.getBoundingClientRect().topconst contentLeft = $content.getBoundingClientRect().left比较boxTop与预设值top的大小,当boxTop比预设值值要小时,即内容即将移出规定的视图范围。这时将内容容器$content设置为fixed。并设置其top值(即预设的top值,吸顶距离),left值与盒子位置相同,故设置为盒子距离的left值当boxTop比预设值值要大时,即内容重新返回的视图范围。则将内容容器$content重新设置会静态布局,让其重新回到盒子布局内部。由于静态布局不受left和top的影响,所以不需要设置left和topif (boxTop > parseInt(this.top) && this.isFixedY) { contentStyle.position = ‘static’} else if (boxTop < parseInt(this.topI) && !this.isFixedY) { contentStyle.position = ‘fixed’ contentStyle.top = this.top contentStyle.left = ${boxLeft}px}在scroll事件中,除了Y轴方向上的滚动,还可能发生X轴方向的滚动。这些需要重新设置fixed元素的left值,让其与盒子容器的left值一致// 当位置距左位置不对时,重新设置fixed对象left的值,防止左右滚动位置不对问题if (contentLeft !== boxLeft && this.left === ‘unset’) { const { $box } = this.$refs const { contentStyle } = this const boxTop = $box.getBoundingClientRect().top const boxLeft = $box.getBoundingClientRect().left if (contentStyle.position === ‘fixed’) { contentStyle.top = this.top contentStyle.left = ${boxLeft}px }}最后,是监听页面的resize事件,防止页面大小变化时,fixed相对页面的变化。同样的,重新设置left值// 当位置距左位置不对时,重新设置fixed对象left的值,防止左右滚动位置不对问题const { $box } = this.$refsconst { contentStyle } = thisconst boxTop = $box.getBoundingClientRect().topconst boxLeft = $box.getBoundingClientRect().leftif (contentStyle.position === ‘fixed’) { contentStyle.top = this.top === ‘unset’ ? ${boxTop}px : this.top contentStyle.left = this.left === ‘unset’ ? ${boxLeft}px : this.left}需要注意的地方目前仅支持top与left值的单独使用,暂不支持同时设置目前仅支持px单位,暂不支持rem及百分比单位设置内容样式时需要注意,设置定位相关属性需要设置在box容器上,例如设置’displCy: inline-block;’,‘verticCl-Clign: top;’,‘margin’设置外观样式,如背景,边框等,则设置在slot内容中即内容content-box以外的设置在box容器中,content-box以内的样式,则设置在slot内容中盒子容器不需要设置position属性,即使有也会被冲刷掉。因为程序将内部重新设置position的值同样的,在样式中设置盒子容器的left和top值也是无效的,会被程序内部重新设置。只能通过dom属性值传递到组件中进行设置后续优化目前本组件仅实现了基本功能,后续还将继续优化以下功能slot内容中,如果有图片,如果获取设置宽高,(监听所有图片的load事件,重新设置容器的高宽)目前仅在mounted中获取slot的宽高,这仅仅是dom元素被渲染,但是dom内容是否加载完毕并不知道的,如img标签,后续在slot中,监听所有img标签的load事件,load中,重新设置组件容器的大小slot内容有变化时,设置容器同样的,当slot内容变化后,重新设置$content的宽高具体如何实现,暂时还没有头绪移动端适配目前只测试了在PC中的效果,暂未在移动端做测试。不排除移动端使用存在坑单位适配目前只支持PX单位,未支持rem,百分百等单位left和top值的混合使用,目前只支持单个属性的使用,暂不支持同时设置项目源码及示例第一稿写完了,撒花花 ...