DEV Community

Cover image for How to Perform Form Validation in React
Nwosa Tochukwu
Nwosa Tochukwu

Posted on

How to Perform Form Validation in React

This guide provides readers with the knowledge and skills they need to implement form validation in React. It covers all the essential aspects of form validation, from understanding the importance of validation to handling form submission.

The guide begins by explaining the importance of form validation. It then shows how to set up a form component and implement validation logic. Next, it discusses how to display validation errors and handle form submissions. Finally, it covers real-time validation, validation libraries, customizing validation logic, testing form validation, and best practices for form validation in React.

The guide is written in a step-by-step manner, making it easy to follow. It also includes code examples and screenshots to help readers understand the concepts.

The ultimate goal of this guide is to help readers create robust and user-friendly forms with accurate data validation in React applications.

Table of Contents

I. Introduction

  • Importance of form validation in web development.
  • Benefits of using Form Validation in React.

II. Setting up the Form Component

  • Create a new component for the form.
  • Setup initial state and form fields.

III. Implementing Form Validation Logic

  • Define validation rules and error messages.
  • Handle form field changes and updates.
  • Perform validation on form submission.

IV. Displaying Validation Errors

  • Create an error state to store the validation form.
  • Display an error message next to the invalid form field.
  • Style the error message for better visuality.

V. Handling Form Submission

  • Prevent Form submission if there are validation errors.
  • Display a success message for a successful submission.
  • Reset Form after submission

VI. Implementing Real-Time Validation

  • Validate form fields as users interact or type with them.
  • Provide feedback on field validity. VII. Using Validation Libraries
  • Explore popular form validation libraries (e.g. Formik, Yup, etc.) VIII. Customizing Validation Logic
  • Implement custom validation functions for complex rules.
  • Handle unique validation scenarios specific to your application. IX. Testing Form Validation
  • Write unit test for form validation logic.
  • Test various scenarios, including valid and invalid. X. Best Practices and Tips
  • Keep validation logic separate from presentation components.
  • Provide clear instructions and error messages to users.
  • Consider accessibility and useability when designing forms XI. Conclusion
  • Recap the importance of form validation.
  • Encouragement to implement form validation in your

I. Introduction

Form validation is a critical part of web development. It ensures that user input is correct, complete, and meets specific requirements.
This guide will walk you through the process of performing form validation in React, so you can create reliable and user-friendly forms for your applications.


II. Setting Up Form Component

To start, we will create a new React component that will handle the form. This component will be the container for all form-related elements and logic. We will start by setting up the initial state to track form data and potential errors. We will then define the necessary form fields using React's controlled components, which will bind them to the state values.

import React, { useState } from 'react';

const MyForm = () => {
  const [formData, setFormData] = useState({
    name: ' ',
    email: ' ',
    password: ' ',
  });

  // Event handlers for form field changes
  const handleInputChange = (e) => {
    const { name, value } = e.target;
    setFormData((prevState) => ({
      ...prevState,
      [name]: value,
    }));
  };

  // ...

  return (
    // JSX code for the form component
  );
};

export default MyForm; 
Enter fullscreen mode Exit fullscreen mode

III. Implementing Form Validation Logic

Now it is time to implement the logic for validating the form. First, define the validation rules for each form field and their corresponding error messages. For example, you might require a minimum length for a password or a valid email format for an email field.
To handle changes to the form fields, set up event handlers that will capture user input. Within these event handlers, perform the necessary validation checks based on the defined rules and update the error state accordingly.

const MyForm = () => {
  const [formData, setFormData] = useState({
    name: ' ',
    email: ' ',
    password: ' ',
  });

  const [formErrors, setFormErrors] = useState({
    name: ' ',
    email: ' ',
    password: ' ',
  });
  // Event handlers for form field changes
  const handleInputChange = (e) => {
    const { name, value } = e.target;
    setFormData((prevState) => ({
      ...prevState,
      [name]: value,
    }));
    // Perform validation checks and update the error state
    if (name === 'name' && value.length < 3) {
      setFormErrors((prevState) => ({
        ...prevState,
        name: 'Name must be at least 3 characters long.',
      }));
    } else if (name === 'email' && !isValidEmail(value)) {
      setFormErrors((prevState) => ({
        ...prevState,
        email: 'Please enter a valid email address.',
      }));
    } else if (name === 'password' && value.length < 8) {
      setFormErrors((prevState) => ({
        ...prevState,
        password: 'Password must be at least 8 characters long.',
      }));
    } else {
      setFormErrors((prevState) => ({
        ...prevState,
        [name]: '', // Reset error message
      }));
    }
  };
   // other codes
}; 
Enter fullscreen mode Exit fullscreen mode

IV. Displaying Validation Errors

To provide users with clear feedback on validation errors, create an error state within the form component. When a form field fails validation, update the error state to store the corresponding error message.
Then, display the error messages next to the respective form fields, making sure they are easily visible. Consider styling the error messages distinctively to draw attention and help users identify and correct their input.

const MyForm = () => {
  // other codes

  return (
    <form>
      <div>
        <label htmlFor="name">Name:</label>
        <input
          type="text"
          id="name"
          name="name"
          value={formData.name}
          onChange={handleInputChange}
        />
        {formErrors.name && <p className="error">{formErrors.name}</p>}
      </div>

      <div>
        <label htmlFor="email">Email:</label>
        <input
          type="email"
          id="email"
          name="email"
          value={formData.email}
          onChange={handleInputChange}
        />
        {formErrors.email && <p className="error">{formErrors.email}</p>}
      </div>

      <div>
        <label htmlFor="password">Password:</label>
        <input
          type="password"
          id="password"
          name="password"
          value={formData.password}
          onChange={handleInputChange}
        />
        {formErrors.password && <p className="error">{formErrors.password}</p>}
      </div>

      <button type="submit">Submit</button>
    </form>
  );
}; 
Enter fullscreen mode Exit fullscreen mode

V. Handling Form Submission

When the user submits the form, prevent the submission if there are any validation errors present. Validate the form data using the defined rules and update the error state with any remaining validation failures.

If the form passes validation, display a success message to indicate a successful submission. Additionally, consider resetting the form by clearing the fields to provide a fresh entry point for the user.

const MyForm = () => {
  // other codes

  const handleSubmit = (e) => {
    e.preventDefault();

    // Final validation check
    const isFormValid = Object.values(formErrors).every((error) => error === ' ');

    if (isFormValid) {
      // Form submission logic
      console.log('Form submitted successfully!');
      // Reset the form
      setFormData({
        name: ' ',
        email: ' ',
        password: ' ',
      });
      setFormErrors({
        name: ' ',
        email: ' ',
        password: ' ',
      });
    } else {
      console.log('Form contains validation errors.');
    }
  };

  return (
    <form onSubmit={handleSubmit}>
      {/* Form fields and error messages */}
    </form>
  );
}; 
Enter fullscreen mode Exit fullscreen mode

VI. Implementing Real-Time Validation

To enhance the user experience, you can implement real-time validation. This means checking the form fields for errors as the user types or interacts with them.

You can use event handlers to capture user input in real-time and trigger the validation logic for the respective form fields. You can then provide instant feedback to users by indicating the validity of their input, such as highlighting the field or displaying an icon indicating success or failure.

const MyForm = () => {
  // other code
  // Event handlers for form field changes
  const handleInputChange = (e) => {
    const { name, value } = e.target;
    setFormData((prevState) => ({
      ...prevState,
      [name]: value,
    }));
    // Perform validation checks and update error state
    if (name === 'name' && value.length < 3) {
      setFormErrors((prevState) => ({
        ...prevState,
        name: 'Name must be at least 3 characters long.',
      }));
    } else if (name === 'email' && !isValidEmail(value)) {
      setFormErrors((prevState) => ({
        ...prevState,
        email: 'Please enter a valid email address.',
      }));
    } else if (name === 'password' && value.length < 8) {
      setFormErrors((prevState) => ({
        ...prevState,
        password: 'Password must be at least 8 characters long.',
      }));
    } else {
      setFormErrors((prevState) => ({
        ...prevState,
        [name]: ' ', // Reset error message
      }));
    }
  };
  // other codes
}; 
Enter fullscreen mode Exit fullscreen mode

VII. Using Validation Libraries

To streamline the form validation process, you can use existing validation libraries, such as Formik and Yup. These libraries provide comprehensive form validation solutions and make it easy to integrate them into your React project.

To get started, explore popular validation libraries and choose the one that best meets your needs. Install the library and integrate it into your React application by following the documentation. Then, use the library-specific methods and components to handle form validation seamlessly, reducing the amount of boilerplate code.

# Install Formik and Yup

npm install formik yup

import { Formik, Form, Field, ErrorMessage } from 'formik';
import * as Yup from 'yup';


const MyForm = () => {
  // other codes  
  const initialValues = {
    name: '',
    email: '',
    password: '',
  };  
  const validationSchema = Yup.object({
    name: Yup.string().required('Name is required.'),
    email: Yup.string().email('Invalid email address.').required('Email is required.'),
    password: Yup.string().min(8, 'Password must be at least 8 characters long.').required('Password is required.'),
  });  
  const handleSubmit = (values, { resetForm }) => {
    // Form submission logic
    console.log('Form submitted successfully!', values);
    resetForm();
  };  
  return (
    <Formik initialValues={initialValues} validationSchema={validationSchema} onSubmit={handleSubmit}>
      <Form>
        <div>
          <label htmlFor="name">Name:</label>
          <Field type="text" id="name" name="name" />
          <ErrorMessage name="name" component="div" className="error" />
        </div>        
        <div>
          <label htmlFor="email">Email:</label>
          <Field type="email" id="email" name="email" />
          <ErrorMessage name="email" component="div" className="error" />
        </div>        
        <div>
          <label htmlFor="password">Password:</label>
          <Field type="password" id="password" name="password" />
          <ErrorMessage name="password" component="div" className="error" />
        </div>        
        <button type="submit">Submit</button>
      </Form>
    </Formik>
  );
}; 
Enter fullscreen mode Exit fullscreen mode

VIII. Customizing Validation Logic

Although many validation scenarios can be covered by built-in rules or validation libraries, you may encounter unique requirements specific to your application. In such cases, it is essential to be able to customize the validation logic.

You can implement custom validation functions to handle complex rules that go beyond the built-in capabilities. These functions can address scenarios where multiple fields have dependencies or need to be validated together. You can adjust the validation logic to suit your specific use cases and integrate it into the existing validation flow.

const MyForm = () => {
  // other codes  
  const isPasswordSecure = (password) => {
    // Custom validation logic for password security
    return password.length >= 8 && password.match(/[a-z]/) && password.match(/[A-Z]/) && password.match(/[0-9]/);
  };
  // other codes  
  const handleInputChange = (e) => {
    // other codes
    // Validation check for password security
    if (name === 'password' && !isPasswordSecure(value)) {
      setFormErrors((prevState) => ({
        ...prevState,
        password: 'Password must be at least 8 characters long and contain at least one lowercase letter, one uppercase letter, and one digit.',
      }));
    }   
    //other codes
  };
  //other codes
}; 
Enter fullscreen mode Exit fullscreen mode

IX. Testing Form Validation

To ensure that your form validation is reliable and accurate, it is essential to write unit tests. These tests should cover a variety of scenarios, including valid and invalid input, to ensure that all edge cases are covered.

You should verify that the error messages are displayed correctly and match the expected validation failures. You should also test the form's behavior when subjected to different validation conditions, ensuring that it handles errors appropriately and allows successful submissions when valid.

import { render, screen, fireEvent } from '@testing-library/react';
import MyForm from './MyForm';

test('Form displays validation errors correctly', () => {
  render(<MyForm />);

  // Attempt to submit the form without entering any values
  fireEvent.click(screen.getByText('Submit'));

  // Verify that error messages are displayed
  expect(screen.getByText('Name is required.')).toBeInTheDocument();
  expect(screen.getByText('Email is required.')).toBeInTheDocument();
  expect(screen.getByText('Password is required.')).toBeInTheDocument();
});

// More tests for different scenarios and form validation rules
// other codes
Enter fullscreen mode Exit fullscreen mode

X Best Practices and Tips

  • Keep the validation logic separate from the presentation components. This will make your code more maintainable and modular, as you can easily reuse the validation logic in different forms.

  • Provide clear instructions and error messages. This will help users understand what they need to do to correct their input. The error messages should be specific and helpful so that users can easily identify and fix the problem.

  • Consider accessibility and usability aspects. This means using ARIA attributes for screen readers and ensuring that the form can be navigated using only the keyboard.
    By following these best practices, you can create effective form validation in your React applications and deliver a smooth and user-friendly experience.


XI. Conclusion

In this guide, we have explored the process of performing form validation in React. By setting up the form component, implementing validation logic, displaying error messages, handling form submissions, leveraging real-time validation, utilizing validation libraries, customizing validation logic, testing form validation, and following best practices, you can create robust and user-friendly forms in your React applications.

With this knowledge, you are well-equipped to incorporate form validation in your React projects and enhance the overall user experience.

Top comments (0)