Repolode
react-hook-form

react-hook-form/react-hook-form

一个 React Hooks 表单库,用于管理表单状态与校验,支持 Web 和 React Native。

Star
44,869
Fork
2,501
未关闭 Issue
7
最近提交
14小时前

这是什么?

React Hook Form 是一个用于 React 的表单状态管理与校验库。它通过 Hook 注册非受控输入框,输入时不会导致整个表单重新渲染,表单变大后依然保持流畅。

校验规则既可以直接内联书写,如 required、pattern 等,也可以通过 resolvers 包接入 Yup、Zod、AJV、Superstruct、Joi 等 schema 校验库。它同时兼容原生 HTML 表单校验,并提供 Controller 组件,便于接入输入值不是普通 DOM 元素的 UI 组件库。

该库没有运行时依赖,以 npm 包形式发布,适用于 React Web 和 React Native 项目。

核心功能

  • 01通过 Hook 注册输入框并保持非受控,减少不必要的重新渲染。
  • 02支持 Yup、Zod、AJV、Superstruct、Joi 等 schema 校验库。
  • 03兼容原生 HTML 表单校验属性。
  • 04提供 Controller 组件,方便接入第三方 UI 组件库。
  • 05无依赖,以 npm 包形式发布。
  • 06同时适用于 React Web 与 React Native。

适用场景

  • 在 React Web 应用中构建登录、注册或结账表单。
  • 为 React Native 移动应用添加带校验的表单。
  • 将 Zod 或 Yup schema 与 UI 组件库的输入控件结合使用。

快速上手

  1. 1

    从 npm 安装该包

    npm install react-hook-form
  2. 2

    导入 useForm 并在 React 组件中使用(参见 README 中的快速入门示例)

标签

常见问题

react-hook-form 是什么?
一个 React Hooks 表单库,用于管理表单状态与校验,支持 Web 和 React Native。 React Hook Form 是一个用于 React 的表单状态管理与校验库。它通过 Hook 注册非受控输入框,输入时不会导致整个表单重新渲染,表单变大后依然保持流畅。
react-hook-form 可以免费使用吗?用的什么许可证?
react-hook-form 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
react-hook-form 还在维护吗?
活跃维护中。react-hook-form 最近一次提交是在 2026年10月20日。
react-hook-form 适合用来做什么?
在 React Web 应用中构建登录、注册或结账表单。 为 React Native 移动应用添加带校验的表单。 将 Zod 或 Yup schema 与 UI 组件库的输入控件结合使用。
react-hook-form 怎么安装和运行?
从 npm 安装该包: npm install react-hook-form 导入 useForm 并在 React 组件中使用(参见 README 中的快速入门示例)
在哪里获取 react-hook-form?
源代码和安装说明在 GitHub 上:https://github.com/react-hook-form/react-hook-form

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目