前端开发中，滑动展现日志麻烦？这个组件来帮你

写在前面
在这个数据无比重要的时代，用户在网页上面的一系列操作，都需要用数据记录下来。在一个网页中，某个元素的点击数，展现数可以说是最基本的指标了。点击数很简单，用户点击的时候，上报一条点击日志即可。但是展现日志，就稍微麻烦一点了。特别是对于必须要上下滑动页面才会出现的元素。滑动展现的场景，在feed流形式的产品上十分常见。所以，一个轻量级的组件，react-scroll-to-show-cb 诞生了。

组件整体介绍
安装：

npm install react-scroll-to-show-cb --save
该组件是基于React开发的，适用于采用react开发的项目。目前主流的react版本都支持。preact也支持，但是需要配置以下的alias :

alias: {
    "react": "preact-compat",
    "react-dom": "preact-compat"
}
使用者只需要将 react组件 或者 html element 直接塞到 react-scroll-to-show-cb 的childern里面去，当对应的元素进入可视区域时，会触发回调函数，并且返回必要的信息。使用者拿到这些信息，就能够上报展现日志了。使用者需要做的，就是完成回调函数里的逻辑即可，十分简单。

组件用法
先看一个例子：

import React from 'react';
import ReactDOM from 'react-dom';
import ReactScrollToShowCb from'react-scroll-to-show-cb';

class App extends React.Component {
    
    render() {
        return <div>
            <ReactScrollToShowCb 
                onScrollToShow={this.handleShow}
                onInitEnd={this.handleInitEnd}
                once={true} 
                wait={500}>
                <div>1</div>
                <div>2</div>
                <div>3</div>
                <div>4</div>
                <div>5</div>
                <div>6</div>
                <div>7</div>
            </ReactScrollToShowCb>
        </div>
    }

    handleShow(index, dom) {
        console.log(`index: ${index}`);
        console.log('dom:', dom);
    }

    handleInitEnd(instance){
        console.log(instance);
    }

}


ReactDOM.render(<App />, document.body);

ReactScrollToShowCb 的 children
支持 Class React Component ，支持 Html Elements, 不支持 Functional React Component 。可以为数组，也可以为单个元素。如果为数组，则数组里面的每个元素都必须为同样的类型，即 属于同一类 Class React Component 或者 同一种 Html Elements。

async
如果你需要异步生成children，你需要设置async参数为true.

onScrollToShow
元素展现时的回调函数，接收 index 和dom作为参数。

onInitEnd
react-scroll-to-show-cb组件初始化后触发，接收组件实例作为参数。

once
多次展现时，是否每次都触发回调函数

wait
组件里监听滑动事件时，用了throttle。wait 控制回调函数的触发频率。

ReactScrollToShowCb.Update
当ReactScrollToShowCb的children被更新时（新增child或者删除child），需要手动调用Update这个静态方法来更新ReactScrollToShowCb。这样，新增的child也会有滑动展现的逻辑，被删除的child也不会再继续触发滑动展现的逻辑。这对于在feed流中 【下拉刷新】和【上滑加载】的业务逻辑十分有用。Update接受一个参数：ReactScrollToShowCb的实例。这个实例可以通过onInitEnd方法获得。

为什么不支持react函数式组件直接作为children
组件在实现是，用了ref来获取原始DOM。而函数式组件不支持ref。之前考虑在函数式组件外面新增一层html，但是这样侵入性太强，直接破坏了原有的DOM结构，特别是在children是数组的情况下，会导致某些css失效。目前没有很好的方法在父组件中获取函数式组件的原始DOM。遇到函数式组件，可以将 ReactScrollToShowCb 写到函数式组件内部return的jsx里面去。

支持异步生成children、增加child、删除child, 但如果后续修改了children, 那么组件将不会继续工作。
考虑到修改children的情况太多，可以新增，替换，删除等等，如果支持所有情况，需要在组件内处理大量因为children变化而带来的逻辑，这样会使组件的复杂程度大大增加，并且对性能也是一个考验。而本组件的定位就是实现一个简单的滑动展现回调功能，所以react-scroll-to-show-cb只支持了异步生成children。而增加child、删除child需要手动调用Update来更新react-scroll-to-show-cb。 但若有对children的修改，组件将停止正常工作。如果有修改children，然后滑动展现触发回调的需求，可以考虑实例化多个react-scroll-to-show-cb来实现。

写在后面