bugl
bugl
HomeLearnPatternsPathsSearchPremium
HomeLearnPatternsPaths
Learn/React/React Core
React•React Core

React Destructuring Props

Destructuring Props

You can limit the properties a component receives by using destructuring.

Example

The component knows it only need the color property, so in the function definition, it only specifies that:

function Car({color}) {
 return ( <h2>My car is {color}!</h2> );
}
createRoot(document.getElementById('root')).render( <Car brand="Ford" model="Mustang" color="red" year={1969} /> );

Note

React uses curly brackets to destructure props: {color} .

You can also destruct the properties you need inside the component.

This way, the component receives all the properties, but the destructuring makes sure it only uses the ones it needs.

Example

The component receives all the properties, but uses destructuring to limit the properties inside the component.

function Car(props) {
 const {brand, model} = props;
 return ( <h2>I love my {brand} {model}!</h2> );
}
createRoot(document.getElementById('root')).render( <Car brand="Ford" model="Mustang" color="red" year={1969} /> );

Destructuring ...rest

When you don't know how many properties you will receive, you can use the ...rest operator.

Meaning: you can specify the properties you need, and the rest will be stored in an object.

Example

The component specifies the color and the brand, but the rest is stored in an object like this: { model: "Mustang", year: 1969 } .

function Car({color, brand, ...rest}) {
 return ( <h2>My {brand} {rest.model} is {color}!</h2> );
}
createRoot(document.getElementById('root')).render( <Car brand="Ford" model="Mustang" color="red" year={1969} /> );

Default Values

With Destructuring, you can set default values for props.

If a property has no value, the default value will be used.

Example

Set the default color value to "blue":

function Car({color = "blue", brand}) {
 return ( <h2>My {color} {brand}!</h2> );
}
createRoot(document.getElementById('root')).render( <Car brand="Ford" /> );

Previous

React Props

Next

React Props Children

This chapter

Overview
45

Lessons

142m

Read time

1. React Tutorial2. React Introduction3. React Getting Started4. Your First React App5. React Render HTML6. Upgrade React7. React ES68. React ES6 Classes9. React ES6 Arrow Functions10. React ES6 Variables11. JavaScript Array map()12. React ES6 Destructuring13. React ES6 Spread Operator14. React ES6 Modules15. React ES6 Ternary Operator16. React ES6 Template Strings17. React JSX18. React JSX Expressions19. React JSX Attributes20. React JSX If Statements21. React Components22. React Class Components23. React Props24. React Destructuring Props25. React Props Children26. React Events27. React Conditional Rendering28. React Lists29. React Forms30. React Submit Forms31. React Forms - Textarea32. React Forms - Select33. React Forms - Multiple Input Fields34. React Forms - Checkbox35. React Forms - Radio36. React Portals37. React Suspense38. Styling React Using CSS39. React CSS Modules40. React CSS-in-JS41. React Router42. React Transitions43. React forwardRef44. React Higher Order Components45. React Sass Styling

On this page

Destructuring PropsDestructuring ...restDefault Values