设计原则
react-simplikit 的设计目标是轻量、可靠、易用。以下原则就是支撑这一设计的核心价值。
尊重 React 的生命周期,不加干涉
react-simplikit 不包含直接干涉 React 生命周期的实现。 例如,它不提供 useMount 或 useLifecycles 这样的 Hook,而是采用尊重并利用 React 默认行为的方式。
通过零依赖做到轻量与快速
react-simplikit 完全没有依赖。由于不依赖任何额外的库,它把接入项目时的包体积降到最低,也让你不必担心性能下降。
通过 100% 测试覆盖率保证可靠性
react-simplikit 会彻底测试每个函数和每个分支。 我们为每个实现编写全面的测试,不仅覆盖基本功能,还考虑到 SSR 环境的情况,从而避免非预期行为引发的问题。 如果你正在寻找一个可靠的库,react-simplikit 会是很好的选择。
完善的文档,易于理解和使用
react-simplikit 提供详细的文档,帮助用户快速理解并用好每个功能。文档包括:
- JSDoc 注释:详细说明每个函数的行为、参数和返回值。
- 使用指南:清晰易懂的步骤,让你立刻上手。
- 实用示例:展示如何在真实场景中运用这些实现的示例。
虽然主要文档以英文提供,但我们也支持韩语、日语和简体中文文档,让这些语言的用户也能轻松查阅。
完整的 TypeScript 支持带来类型安全
react-simplikit 从一开始就用 TypeScript 构建。每个 Hook 和工具函数都具备:
- 严格的类型定义:所有参数、返回值和选项都有完整的类型
- IntelliSense 支持:在 IDE 中获得自动补全和内联文档
- 泛型:灵活的 API,保留你的类型信息
- 不使用
any类型:我们避免使用会破坏类型安全的脱围机制