fabianfalon / react-hook-form

📋 React hook for form validation without the hassle

English | 简体中文

React hook form validation without the hassle

 

• Super easy to integrate and create forms
• Built with performance and developer experience in mind
• Follows HTML standard for validation
• Tiny size without any dependency
• Build forms quickly with the form builder

Install

$ npm install react-hook-form

Docs

• Motivation
• Get started
• API
• Examples
• Demo
• Form Builder

Quickstart

import React from 'react'
import useForm from 'react-hook-form'

function App() {
  const { register, handleSubmit, errors } = useForm() // initialise the hook
  const onSubmit = (data) => { console.log(data) } // callback when validation pass
    
  return (
    <form onSubmit={handleSubmit(onSubmit)}>
      <input name="firstname" ref={register} /> {/* register an input */}
      
      <input name="lastname" ref={register({ required: true })} /> {/* apply required validation */}
      {errors.lastname && 'Last name is required.'} {/* error message */}
      
      <input name="age" ref={register({ pattern: /\d+/ })} /> {/* apply pattern validation */}
      {errors.age && 'Please enter number for age.'} {/* error message */}
      
      <input type="submit" />
    </form>
  )
}

Contributors

Thanks goes to these wonderful people: