@gilbarbara/hooks

中文文档
0.11.0发布于 2026/02/07MITTypeScriptESM + CJS构建来源已验证近 30 天下载 448.5万

收集有用的反应钩

中文使用文档
文档目录17 节
  1. 设置
  2. 特征
  3. 示例
  4. 钩子
  5. 用深比对反应钩
  6. 状态
  7. 效果
  8. 生命周期
  9. 参考文献和DOM
  10. 用户界面和相互作用
  11. 业绩和优化
  12. 计时器
  13. 数据获取
  14. 调试与发展
  15. 公用事业
  16. ESLint 配置
  17. 许可证

@gilbarbara/呼和浩克

npm version CI Quality Gate Status Coverage

用于简化状态管理,副作用和UI相互作用的React hooks集合.

设置

npm i @gilbarbara/hooks

需要回放16.8+(Hooks支持). 包含类型脚本支持.

特征

  • 自定义版本 useEffect, (中文(简体) ), useCallback,以及 useMemo 与深度对比.
  • 为平稳性能而设的减振和节奏(useDebounce, (中文(简体) ), useThrottle) (中文(简体) ).
  • 高级国家管理useSetState, (中文(简体) ), useToggle, (中文(简体) ), usePersistentState) (中文(简体) ).
  • 调试工具以优化重置( D)useDataChanges, (中文(简体) ), useRenderCount) (中文(简体) ).
  • 弹性API集成useFetch 带有再试和后退支持).

示例

这是使用 useToggle, (中文(简体) ), useThrottle,以及 useFetch 组合:

import { useToggle, useThrottle, useFetch } from '@gilbarbara/hooks';

function Component() {
  const [isEnabled, { toggle }] = useToggle(false);
  const throttledFetch = useThrottle(() => {
    fetch('/api/data');
  }, 1000);
  const { data, error } = useFetch('/api/data');

  return (
    <div>
      <button onClick={toggle}>{isEnabled ? 'Disable' : 'Enable'}</button>
      <button onClick={throttledFetch}>Fetch Data</button>
      {error ? <p>Error: {error.message}</p> : <p>Data: {JSON.stringify(data)}</p>}
    </div>
  );
}

钩子

用深比对反应钩

自定义反应的内置钩 深度比较 他们的依赖.

使用CallbackDepperCompare 调用 - 习惯 useCallback 与深度对比.
使用效果深端压缩 - 习惯 useEffect 与深度对比.
使用MemoDepCompare 软件 - 习惯 useMemo 与深度对比.

状态

用于管理和持续应用状态的钩子.

使用持续状态 ——国家悬钩子,使该州长期处于地道.
使用设置状态 ——返回将对象变化合并到当前状态的设置状态.
使用切换 ——州钩来追踪布尔值.

效果

管理副作用和扩展反应作用的钩子.

使用效果 ——只执行一次效果.
变化 ——检测值变化并可选择地触发回调.
使用IsomorphicLayout效应 ——对客户端使用Layouteffect,对服务器使用effect.
使用更新效果 ——习惯使用效果不运行在挂载上.

生命周期

用于管理组件生命周期事件的钩子,例如起跑和卸载.

使用月球 ——在组件挂起时执行回调.
使用卸载 ——当组件被卸载时执行回调.
使用生命周期Hooks ——当组件挂起并卸起时执行回调.
使用已模拟 ——检查组件是否仍然挂载.
使用首选项 - 检查它是否是第一个挂载.

参考文献和DOM

用于管理裁判和与DOM互动的钩子.

使用最近数 找到一个包含最新值的裁判.
使用元参考 ——将多对数合并为一.
上一个 ——跟踪变量的上一个值.

用户界面和相互作用

Hooks用于管理用户互动和响应性设计.

使用断点 ——获取适应性布局的响应断点.
使用 Click 外部 ——点击目标元素外时执行回调.
使用元素计量 ——使用调整观察员API获取元素维度.
使用媒体查询 ——检测媒体查询变化.
使用界面观察员 - 探测到一个要素在取景口的能见度 交叉观察员 API (英语).
回复观察员 - 使用 调整观察员的大小 API (英语).
使用窗口大小 - 获取窗口尺寸。 调整大小的最新情况.

业绩和优化

通过减少不必要的执行频率或控制频率来优化性能的钩子.

调试 ——推迟运行执行,直到上次援引后延迟结束.
调用 数值 ——获得一个稳定值,只有在原始值真正不同时才会更新.
使用色调 返回每毫秒一次引用 fn 的节奏函数.
使用ThrottleValue 软件 ——返回每毫秒只变化一次的受压值.

计时器

Hooks用于管理基于时间的操作.

使用Interval系统 ——以指定的延迟反复执行回调.
使用超时 ——在指定延迟后执行回调.

数据获取

Hooks)用于与API和第三方脚本合作.

使用图像 - 请求取回。 它支持动态的URL,缓存,再试等更多功能.
使用脚本 ——动态地加载脚本标记并附入文档.body.

调试与发展

钩子用于调试,监测和优化组件行为.

使用数据变化 检测哪个道/状态变化导致一个组件重新投放.
使用“调制解码” 记录组件已提供多少次.
使用更新 ——返回调用时重置组件的函数.

公用事业

使用本地服务器 ——与浏览器本地Storage API互动.
用户地址 ——跟踪浏览器位置.
用户 ——在组件产生前一次执行代码.

ESLint 配置

为了充分利用有依赖关系的钩子,在你的ESLint配置中加入以下规则: 使用自定义的钩子

{
  "rules": {
    "react-hooks/exhaustive-deps": [
      "warn", {
        "additionalHooks": "(useDebounce|useUpdateEffect|use.*DeepCompare)"
      }
    ]
  }
}

许可证

麻省理工学院

版本与发布记录

@gilbarbara/hooks 共发布 27 个版本,首次发布于 2020/03/06;过去 12 个月发布了 2 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.11.0latest2026/02/079 个月前
0.10.52026/02/049 个月前
0.10.42025/02/161.7 年前
0.10.32025/02/161.7 年前
0.10.22025/02/081.8 年前
0.10.12025/02/031.8 年前

关于 @gilbarbara/hooks 的常见问题

@gilbarbara/hooks 是什么?

收集有用的反应钩

如何安装 @gilbarbara/hooks?

在项目目录运行 npm install @gilbarbara/hooks,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(16.8 - 19)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@gilbarbara/hooks 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@gilbarbara/hooks 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@gilbarbara/hooks 可以商用吗?

@gilbarbara/hooks 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@gilbarbara/hooks 的下载量有多少?

根据 npm 官方下载统计,@gilbarbara/hooks 在 2026/10/17 – 2026/11/15 这 30 天内被下载 4,484,888 次,日均约 149,496 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gilbarbara/hooks 还在维护吗?

最新版本 0.11.0 发布于 2026/02/07(9 个月前);至今共发布 27 个版本,其中过去 12 个月发布了 2 个;首次发布于 2020/03/06。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。