What are controlled components and uncontrolled components in ReactJS? How do they differ from each other?
5 Answers
This relates to stateful DOM components (form elements) and the React docs explain the difference:
- A Controlled Component is one that takes its current value through
propsand notifies changes through callbacks likeonChange. A parent component "controls" it by handling the callback and managing its own state and passing the new values as props to the controlled component. You could also call this a "dumb component". - A Uncontrolled Component is one that stores its own state internally, and you query the DOM using a
refto find its current value when you need it. This is a bit more like traditional HTML.
Most native React form components support both controlled and uncontrolled usage:
// Controlled:
<input type="text" value={value} onChange={handleChange} />
// Uncontrolled:
<input type="text" defaultValue="foo" ref={inputRef} />
// Use `inputRef.current.value` to read the current value of <input>
In most (or all) cases you should use controlled components.
- 45,174
- 23
- 78
- 99
-
2Isn't the value taken through `state` rather than `props`? – Ivanka Todorova Oct 04 '18 at 20:27
-
19@IvankaTodorova For a controlled component the value is passed in through `props`. An uncontrolled component would use `state` to control the value itself internally. This is the key difference. – Aaron Beall Oct 04 '18 at 20:51
-
6The difference between them is that components that their value is set/passed and have a callback are called `controlled components` (``) vs. traditional HTML where an input element handle their own value and can be read via `refs` called `uncontrolled components` (`
`). Controlled components are managing their own state via `setState` or getting it from their parent component as props. – Lior Elrom Feb 12 '19 at 13:13 -
How would you call a component that gets it `defaultValue` through props, but which notifies the controller `onBlur`? – Paul Razvan Berg Dec 05 '19 at 12:04
-
@PaulRazvanBerg That sounds like an anti-pattern, [state should be controlled in a single place](https://reactjs.org/docs/thinking-in-react.html#step-4-identify-where-your-state-should-live). Usually you will [lift state](https://reactjs.org/docs/lifting-state-up.html) to the closest common ancestor. – Aaron Beall Dec 05 '19 at 18:00
-
Yeah, so that's I'm doing, I'm lifting the state on `onBlur`. – Paul Razvan Berg Dec 05 '19 at 23:03
-
@PaulRazvanBerg I probably don't quite understand your setup, perhaps make a SO question and at-mention me. – Aaron Beall Dec 05 '19 at 23:12
-
There you go, Aaron: https://stackoverflow.com/questions/59204630/is-this-a-controlled-or-uncontrolled-react-component – Paul Razvan Berg Dec 05 '19 at 23:18
-
Are there any pros to using uncontrolled components, is there any performance difference? – Lasantha Basnayake Jan 16 '20 at 17:48
-
A component that doesn't take any props or don't have any state is also an uncontrolled component. – 8bitIcon Dec 17 '20 at 03:47
-
need edit?....... – Snowmanzzz Nov 17 '21 at 01:42
They both render form elements
Uncontrolled component and Controlled component are terms used to describe React components that render HTML form elements. Every time you create a React component that renders an HTML form element, you are creating one of those two.
Uncontrolled components and Controlled components differ in the way they access the data from the form elements (<input>, <textarea>, <select>).
Uncontrolled Components
An uncontrolled component is a component that renders form elements, where the form element's data is handled by the DOM (default DOM behavior). To access the input's DOM node and extract its value you can use a ref.
Example - Uncontrolled component:
const { useRef } from 'react';
function Example () {
const inputRef = useRef(null);
return <input type="text" defaultValue="bar" ref={inputRef} />
}
Controlled Components
A controlled component is a component that renders form elements and controls them by keeping the form data in the component's state.
In a controlled component, the form element's data is handled by the React component (not DOM) and kept in the component's state. A controlled component basically overrides the default behavior of the HTML form elements.
We create a controlled component by connecting the form element (<input>, <textarea> or <select>) to the state by setting its attribute value and the event onChange.
Example - Controlled Component:
const { useState } from 'react';
function Controlled () {
const [email, setEmail] = useState();
const handleInput = (e) => setEmail(e.target.value);
return <input type="text" value={email} onChange={handleInput} />;
}
- 1,258
- 2
- 20
- 29
-
4I think this answer is better than the accepted one. Cleared my thoughts. Upper one is little bit confusing for me – Maddy8381 Jan 24 '22 at 15:32
-
1This is by far the best and most straightforward answer I've come across.. thank you @ross_u! – Ankit_M Apr 22 '22 at 05:27
Controlled component is component that get the changed value from the callback function and uncontrolled component is component that have the one from the DOM. For example, When input value is changed,we can use onChange function in Controlled Component and also we can get the value using DOM like ref.
Controlled components are mainly those where any prop value of the component is either from the parent component or from the store (as in case of redux). Example:
<ControlledComp value={this.props.fromParent}/>
In case of an uncontrolled component, the component value can be taken from the state of the component depending on the event handling. Example:
<UncontrolledComp value={this.state.independentValue}/>
- 8,101
- 11
- 72
- 75
- 35
- 2
-
5This doesn't explain the concept. Please take help from other answers or simply delete this answer – salvi shahzad Oct 06 '21 at 04:41
Controlled components do not hold their state.
Data they need is passed down to them from a parent component.
They interact with this data by callback functions, which are also passed from the parent to the child.
- 115
- 7