[源码阅读]通过react-infinite-scroller理解滚动加载要点

react-infinite-scroller就是一个组件,主要逻辑就是addEventListener绑定scroll事件。
看它的源码主要意义不在知道如何使用它,而是知道以后处理滚动加载要注意的东西。
此处跳到总结。
初识
参数:
// 渲染出来的DOM元素name
element: ‘div’,
// 是否能继续滚动渲染
hasMore: false,
// 是否在订阅事件的时候执行事件
initialLoad: true,
// 表示当前翻页的值(每渲染一次递增)
pageStart: 0,
// 传递ref,返回此组件渲染的 DOM
ref: null,
// 触发渲染的距离
threshold: 250,
// 是否在window上绑定和处理距离
useWindow: true,
// 是否反向滚动,即到顶端后渲染
isReverse: false,
// 是否使用捕获模式
useCapture: false,
// 渲染前的loading组件
loader: null,
// 自定义滚动组件的父元素
getScrollParent: null,

深入
componentDidMount
componentDidMount() {
this.pageLoaded = this.props.pageStart;
this.attachScrollListener();
}
执行attachScrollListener

attachScrollListener
attachScrollListener() {
const parentElement = this.getParentElement(this.scrollComponent);

if (!this.props.hasMore || !parentElement) {
return;
}

let scrollEl = window;
if (this.props.useWindow === false) {
scrollEl = parentElement;
}
scrollEl.addEventListener(
‘mousewheel’,
this.mousewheelListener,
this.props.useCapture,
);
scrollEl.addEventListener(
‘scroll’,
this.scrollListener,
this.props.useCapture,
);
scrollEl.addEventListener(
‘resize’,
this.scrollListener,
this.props.useCapture,
);

if (this.props.initialLoad) {
this.scrollListener();
}
}
此处通过getParentElement获取父组件(用户自定义父组件或者当前dom的parentNode)
然后绑定了3个事件,分别是scroll,resize,mousewheel
前2种都绑定scrollListener,mousewheel是一个非标准事件,是不建议在生产模式中使用的。
那么这里为什么要使用呢?

mousewheel解决chrome的等待bug
此处的mousewheel事件是为了处理chrome浏览器的一个特性(不知道是否是一种bug)。
stackoverflow:Chrome的滚动等待问题
上面这个问题主要描述,当在使用滚轮加载,而且加载会触发ajax请求的时候,当滚轮到达底部,会出现一个漫长而且无任何动作的等待(长达2-3s)。
window.addEventListener(“mousewheel”, (e) => {
if (e.deltaY === 1) {
e.preventDefault()
}
})
以上绑定可以消除这个”bug”。
个人并没有遇到过这种情况,不知道是否有遇到过可以说说解决方案。

getParentElement
getParentElement(el) {
const scrollParent =
this.props.getScrollParent && this.props.getScrollParent();
if (scrollParent != null) {
return scrollParent;
}
return el && el.parentNode;
}
上面用到了getParentElement,很好理解,使用用户自定义的父组件,或者当前组件DOM.parentNode。

scrollListener
scrollListener() {
const el = this.scrollComponent;
const scrollEl = window;
const parentNode = this.getParentElement(el);

let offset;
// 使用window的情况
if (this.props.useWindow) {
const doc = document.documentElement || document.body.parentNode || document.body;
const scrollTop = scrollEl.pageYOffset !== undefined
? scrollEl.pageYOffset
: doc.scrollTop;
// isReverse指 滚动到顶端,load新组件
if (this.props.isReverse) {
// 相反模式获取到顶端距离
offset = scrollTop;
} else {
// 正常模式则获取到底端距离
offset = this.calculateOffset(el, scrollTop);
}
// 不使用window的情况
} else if (this.props.isReverse) {
// 相反模式组件到顶端的距离
offset = parentNode.scrollTop;
} else {
// 正常模式组件到底端的距离
offset = el.scrollHeight – parentNode.scrollTop – parentNode.clientHeight;
}

// 此处应该要判断确保滚动组件正常显示
if (
offset < Number(this.props.threshold) &&
(el && el.offsetParent !== null)
) {
// 卸载事件
this.detachScrollListener();
// 卸载事件后再执行 loadMore
if (typeof this.props.loadMore === ‘function’) {
this.props.loadMore((this.pageLoaded += 1));
}
}
}
组件核心。
几个学习/复习点

offsetParent
offsetParent返回一个指向最近的包含该元素的定位元素.
offsetParent很有用,因为计算offsetTop和offsetLeft都是相对于offsetParent边界的。
ele.offsetParent为 null 的3种情况:

ele 为body

ele 的position为fixed

ele 的display为none
此组件中offsetParent处理了2种情况

在useWindow的情况下(即事件绑定在window,滚动作用在body)
通过递归获取offsetParent到达顶端的高度(offsetTop)。
calculateTopPosition(el) {
if (!el) {
return 0;
}
return el.offsetTop + this.calculateTopPosition(el.offsetParent);
}

通过判断offsetParent不为null的情况,确保滚动组件正常显示
if (
offset < Number(this.props.threshold) &&
(el && el.offsetParent !== null)
) {/* … */ }

scrollHeight和clientHeight在无滚动的情况下,scrollHeight和clientHeight相等,都为height+padding*2
在有滚动的情况下,scrollHeight表示实际内容高度,clientHeight表示视口高度。

每次执行loadMore前卸载事件。确保不会重复(过多)执行loadMore,因为先卸载事件再执行loadMore,可以确保在执行过程中,scroll事件是无效的,然后再每次componentDidUpdate的时候重新绑定事件。

render
render() {
// 获取porps
const renderProps = this.filterProps(this.props);
const {
children,
element,
hasMore,
initialLoad,
isReverse,
loader,
loadMore,
pageStart,
ref,
threshold,
useCapture,
useWindow,
getScrollParent,
…props
} = renderProps;

// 定义一个ref
// 能将当前组件的DOM传出去
props.ref = node => {
this.scrollComponent = node;
// 执行父组件传来的ref(如果有)
if (ref) {
ref(node);
}
};

const childrenArray = [children];
// 执行loader
if (hasMore) {
if (loader) {
isReverse ? childrenArray.unshift(loader) : childrenArray.push(loader);
} else if (this.defaultLoader) {
isReverse
? childrenArray.unshift(this.defaultLoader)
: childrenArray.push(this.defaultLoader);
}
}
// ref 传递给 ‘div’元素
return React.createElement(element, props, childrenArray);
}
这里一个小亮点就是,在react中,this.props是不允许修改的。
这里使用了解构
getScrollParent,
…props
} = renderProps;
这里解构相当于Object.assign,定义了一个新的object,便可以添加属性了,并且this.props不会受到影响。
总结
react-infinite-scroller逻辑比较简单。
一些注意/学习/复习点:

Chrome的一个滚动加载请求的bug。本文位置

offsetParent的一些实际用法。本文位置

通过不断订阅和取消事件绑定让滚动执行函数不会频繁触发。本文位置

scrollHeight和clientHeight区别。本文位置

此库建议使用在自定义的一些组件上并且不那么复杂的逻辑上。
用在第三方库可以会无法获取正确的父组件,而通过document.getElementBy..传入。
面对稍微复杂的逻辑,
例如,一个搜索组件,订阅onChange事件并且呈现内容,搜索”a”,对呈现内容滚动加载了3次,再添加搜索词”b”,这时候”ab”的内容呈现是在3次之后。

评论

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

这个站点使用 Akismet 来减少垃圾评论。了解你的评论数据如何被处理