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