总览
@nild/hooks 提供了一组围绕状态、引用、事件和副作用组织方式设计的 React Hooks。它们的 API 都很小,重点是让常见模式更稳定、更容易复用。
状态
- useControllableState:统一受控与非受控两种状态模式。
- useLocalStorage:像
useState一样读写localStorage。 - usePrevious:读取上一次被接受的值。
- useForceUpdate:在不引入业务状态时强制当前组件重新渲染。
副作用
- useEffectCallback:返回稳定引用,并始终调用最新实现的副作用回调。
- useCustomCompareEffect:为
useEffect增加可定制的依赖比较逻辑。 - useIsomorphicLayoutEffect:在浏览器中使用
useLayoutEffect,在非浏览器环境中回退到useEffect。 - useMount:在组件首次挂载后执行一次逻辑。
- useUnmount:在组件卸载时执行清理逻辑。
Ref
- useLatestRef:返回稳定的 ref 对象,并让
current始终指向最新值。 - usePureCallback:返回稳定引用,并始终调用最新实现的纯函数回调。
DOM
- useEventListener:以更稳定的方式绑定和清理事件监听器。