Skip to content

设计原则

react-simplikit 的设计目标是轻量、可靠、易用。以下原则就是支撑这一设计的核心价值。

尊重 React 的生命周期,不加干涉

react-simplikit 不包含直接干涉 React 生命周期的实现。 例如,它不提供 useMountuseLifecycles 这样的 Hook,而是采用尊重并利用 React 默认行为的方式。

通过零依赖做到轻量与快速

react-simplikit 完全没有依赖。由于不依赖任何额外的库,它把接入项目时的包体积降到最低,也让你不必担心性能下降。

通过 100% 测试覆盖率保证可靠性

react-simplikit 会彻底测试每个函数和每个分支。 我们为每个实现编写全面的测试,不仅覆盖基本功能,还考虑到 SSR 环境的情况,从而避免非预期行为引发的问题。 如果你正在寻找一个可靠的库,react-simplikit 会是很好的选择。

完善的文档,易于理解和使用

react-simplikit 提供详细的文档,帮助用户快速理解并用好每个功能。文档包括:

  • JSDoc 注释:详细说明每个函数的行为、参数和返回值。
  • 使用指南:清晰易懂的步骤,让你立刻上手。
  • 实用示例:展示如何在真实场景中运用这些实现的示例。

虽然主要文档以英文提供,但我们也支持韩语、日语和简体中文文档,让这些语言的用户也能轻松查阅。

完整的 TypeScript 支持带来类型安全

react-simplikit 从一开始就用 TypeScript 构建。每个 Hook 和工具函数都具备:

  • 严格的类型定义:所有参数、返回值和选项都有完整的类型
  • IntelliSense 支持:在 IDE 中获得自动补全和内联文档
  • 泛型:灵活的 API,保留你的类型信息
  • 不使用 any 类型:我们避免使用会破坏类型安全的脱围机制

基于 MIT 许可证发布。