DEV Community

Abhay Singh Kathayat
Abhay Singh Kathayat

Posted on

Controlled vs Uncontrolled Components in React: Choosing the Right Approach

Controlled vs Uncontrolled Components in React: Understanding the Difference

In React, managing form elements like input fields, checkboxes, and textareas can be done using either controlled components or uncontrolled components. These two approaches offer different methods for handling and updating the form data, and understanding the difference between them is essential for choosing the right method for your React applications.


1. What are Controlled Components?

In controlled components, form elements are controlled by the React component's state. The form data is managed through React's state, and any changes made by the user are reflected in the component's state. The React component acts as the "single source of truth" for the form data.

How Controlled Components Work:

  • The form element (like an <input> field) has its value controlled by the state of the component.
  • Any user input triggers an onChange event, which updates the state in the parent component.
  • The state is then passed back down to the form element, ensuring that it remains in sync with the application state.

Example of Controlled Component:

import React, { useState } from 'react';

const ControlledForm = () => {
  const [inputValue, setInputValue] = useState('');

  const handleChange = (e) => {
    setInputValue(e.target.value);  // Update the state with the user input
  };

  return (
    <form>
      <input 
        type="text" 
        value={inputValue}       // Value is controlled by React state
        onChange={handleChange}   // Updates state on user input
      />
      <button type="submit">Submit</button>
    </form>
  );
};

export default ControlledForm;
Enter fullscreen mode Exit fullscreen mode

Advantages of Controlled Components:

  • Centralized control: The state is managed in one place (the React component), making it easier to track and validate form data.
  • Predictability: Since React's state is the source of truth, the form element is always in sync with the state, ensuring predictability.
  • Easy validation: You can perform real-time form validation or conditional rendering based on the input values, as the data is part of the component state.

2. What are Uncontrolled Components?

In uncontrolled components, form elements are managed by the DOM itself, rather than React's state. React does not track the form element's value directly. Instead, you use refs (references) to access the DOM elements and retrieve their current values.

How Uncontrolled Components Work:

  • The form elements' values are stored in the DOM, not in the React component's state.
  • A ref is used to directly access the DOM element and retrieve or modify its value.
  • You can optionally use an onSubmit handler to process the data when the form is submitted.

Example of Uncontrolled Component:

import React, { useRef } from 'react';

const UncontrolledForm = () => {
  const inputRef = useRef();

  const handleSubmit = (e) => {
    e.preventDefault();
    alert(`Input Value: ${inputRef.current.value}`); // Access value using ref
  };

  return (
    <form onSubmit={handleSubmit}>
      <input type="text" ref={inputRef} /> {/* Using ref to access value */}
      <button type="submit">Submit</button>
    </form>
  );
};

export default UncontrolledForm;
Enter fullscreen mode Exit fullscreen mode

Advantages of Uncontrolled Components:

  • Less boilerplate: No need to manage state for form elements, making the code cleaner and simpler, especially for forms with large numbers of fields.
  • Performance: Since the form elements' values are not stored in React's state, uncontrolled components can sometimes offer better performance in scenarios with many dynamic inputs or complex forms.
  • More natural for simple use cases: For very simple forms or when you don’t need to interact with the form data while the user is typing, uncontrolled components can be a simpler solution.

3. Controlled vs Uncontrolled Components: Key Differences

Feature Controlled Components Uncontrolled Components
State Management Data is managed by React’s state. Data is managed by the DOM, using refs.
Data Flow Value is passed as a prop and updated via state. Value is accessed directly through the DOM.
Form Validation Easy to validate and control form data in real-time. Validation is more complex and may require additional handling.
Boilerplate Code Requires more code to manage state and updates. Less boilerplate code but requires refs for accessing form data.
Performance May be slower with a large number of form elements. Faster for large forms or when you don’t need real-time data updates.
Complexity Offers more flexibility and control over form behavior. Simpler and more straightforward for simple forms.

4. When to Use Controlled Components?

Controlled components are the preferred choice when:

  • You need to dynamically interact with the form data (e.g., validation, conditional rendering).
  • You require real-time updates to the form data (e.g., live search, form validation).
  • You need to manage and validate multiple inputs across the form.

5. When to Use Uncontrolled Components?

Uncontrolled components are more suitable when:

  • You have simple forms with no need for real-time interaction or validation.
  • You want to reduce the complexity of handling form data in React.
  • Performance is critical, and the form elements are not expected to change dynamically or be interacted with in real time.

6. Conclusion

Both controlled and uncontrolled components have their place in React applications. Controlled components offer greater control and predictability, making them ideal for most complex forms. However, uncontrolled components can be a simpler and more performance-efficient solution for basic forms or when you don't need real-time control over the data.

Understanding when to use each type of component will help you decide the best approach based on your specific use case.

Top comments (0)