,最近公司的前端项目从 React 16 升级到了 React 17,导致 ahooks 的 useClickAway 不能按预期工作。,下面西瓜哥我就来说说到底发生了什么事。,ahooks 是阿里巴巴维护的第三方 React Hook 库,里面封装了很多好用的 hook。,比如经常用到的组件挂载以及卸载的 useMount、useUnmount,还有支持自动请求、手动请求、防抖等各种功能请求 useRequest,以及可以将状态同步存取到 localStorage 的 useLocalStorageState。,当你想要写一个与业务无关的第三方 ahooks,你可以去 ahooks 里面找找,大概率能够找到,是比较优秀的 hook 库。,其中,useClickAway 的作用是 监听目标元素外的点击事件。,useClickAway 接受的第一个参数是一个事件回调函数。,第二个参数是被排除的目标元素,可以是 ref 或 DOM 元素,或者是它们组成的数组,,第三个是需要监听的事件类型字符串或事件字符串数组。第三个参数是可选的,不使用的话默认用点击事件 'click'。,下面是一个常用的写法:,核心底层原理是,是在 document 上绑定了一个冒泡事件。当事件冒泡到 document 时,会判断事件目标元素是否为传入的 ref 下的子元素。,如果是,什么都不做。如果不是,执行回调函数。,这里给出 useClickAway 的源码地址,感兴趣的话可以研究一下:,https://github.com/alibaba/hooks/blob/v3.5.0/packages/hooks/src/useClickAway/index.ts。,如果你在 React 16 中使用 useClickAway,一切都表现良好。,但如果是 React 17 及以上版本使用,在一些情况下会有问题。,我们有这么一个场景。,点击一个搜索按钮,会出现一个输入框,此时用户需要在这个输入框内输入文字来搜索。如果点击到搜索按钮外的地方,输入框会消失。,
,核心实现如下:,这里提供一个线上 demo(用的是 React 17 版本):,https://codesandbox.io/s/f54siy。,在 React 16 的时候,上面的写法是正常的。但升级到 17 后,你会发现点击 button 后什么事情都没有发生。,原因在于 React 17 对事件系统进行了改造。,16 升级到 17 后,React 将事件委托到 ReactDOM 挂载的根节点上,比如 div#app,而不再是原来 document。,
,首先,我们要知道的是,当调用 setVisible(true) 改变组件状态时,组件就立即被重新渲染了,然后调用了 useClickAway。状态更新后的组件重渲染是同步的,此时我们的事件流其实还没有结束。,在 React 16 中,事件都委托到了 document 上。,我们点击 button 元素,产生了一个事件流,当点击事件流动到 document 时,我们将 visible 设置为 true,组件进行了一次同步的重新渲染,并调用 useClickAway,做了个 document 上的冒泡事件绑定。,就像下面这样:,在一个元素的事件触发过程中,往这个元素上注册新的相同类型的事件响应函数,这个新的响应函数不会在此次事件流上立即触发。,所以,前面的 useClickAway 写法在 React 16 是正常的。,但是,在 React 17 中就不同了,事件委托下放到了 div#app 中。,
,点击按钮,事件流冒泡到 div#app 元素,执行事件回调函数将 visible 设置为了 true,并重新渲染组件,执行 useClickAway 再给 document 绑定了新的事件响应函数。,此时事件流没有结束,继续冒泡到 document,将 visible 又设置回了 false。,所以,visible 在短暂地变成 true 后,又变回了 false,无事发生。,我们给按钮加上阻止事件冒泡,提前结束事件流,使其不流到 document 上,就不会触发 document 的点击事件。,但这样也是有隐患的,e.stopPropagation 是破坏性的。,如果我们在其他的地方要写一些特殊的判断失焦逻辑,也要用到类似 useClickAway 的做法,我们点到这个 button 上就会让其他地方的逻辑走不通。,mousedown 在 click 事件之前就结束了,所以在 click 事件流过程中不会触发它。,touchstart 是为了兼容移动设备的情况。因为触屏时,touchstart 一定会触发,mousedown 不一定,顺带一提,click 也不一定。,其他的比较优秀的第三方 React Hooks 库,比如 react-use 的 useClickAway,其实就是用 mousedown 和 touchstart 作为默认事件类型。,还有百度的 react-hooks 库,其下的 useClickOutside 不支持自定义事件类型,但也是用的 mousedown 和 touchstart。,这样就可以把 button 也排除在触发条件外。,但这样写很繁琐。如果输入框要封装成一个组件,你还得把 buttonRef 传入到这个组件中。,通过 setTimeout 的方式,确保输入框的出现在同步的事件流之后才出现,然后才触发 useClickAway 绑定逻辑。,React 16 升级为 17 后,React 中混合事件托管绑定到了 React 组件树挂载的 div#app 上,不再是之前的 document。,这让默认注册为 click 事件类型的 useClickAway 在一些场景下,表现上和 React 16 有一些不同。,对于上面的场景以及解决方案,我认为最好的是第二种:给 useClickAway 的事件类型设置为 mousedown 和 touchstart。这种方法更有普适性。
© 版权声明
文章版权归作者所有,未经允许请勿转载。