What does ...rest mean in React JSX?
Sorry, I realized my first answer (while hopefully still providing useful/additional context) doesn't answer your question. Let me try again.
You ask:
I want to be certain that
{ component: Component, ...rest }
means:From
props
, get theComponent
prop and then all otherprops
given to you, and renameprops
torest
so you can avoid naming issues with theprops
passed to the Routerender
function
Your interpretation is not quite correct. Based on your thoughts though, it sounds like you're at least aware of the fact that what is happening here amounts to some sort of object destructuring (see second answer and comments there for more clarification).
To give an accurate explanation, let's break down the { component: Component, ...rest }
expression into two separate operations:
-
Operation 1: Find the
component
property defined onprops
(Note: lowercase component) and assign it to a new location in state we callComponent
(Note: capital Component). -
Operation 2: Then, take all remaining properties defined on the
props
object and collect them inside an argument calledrest
.
The important point is that you're NOT renaming props
to rest
. (And nor does it have to do with trying to "avoid naming issues with the props
passed to the Route render
function".)
rest === props;
// => false
You're simply pulling off the rest (hence why the argument is named that) of the properties defined on your props
object into a new argument called rest
.
Example Usage
Here's an example. Let's assume we have an object `myObj` defined as follows:const myObj = {
name: 'John Doe',
age: 35,
sex: 'M',
dob: new Date(1990, 1, 1)
};
For this example, it may help to just think of props
as having the same structure (i.e., properties and values) as shown in myObj
. Now, let's write the following assignment.
const { name: Username, ...rest } = myObj
The statement above amounts to both the declaration and assignment of two variables (or, I guess, constants). The statement can be thought out as:
Take property
name
defined onmyObj
and assign its value to a new variable we callUsername
. Then, take whatever other properties were defined onmyObj
(i.e.,age
,sex
anddob
) and collect them into a new object assigned to the variable we namerest
.
Logging Username
and rest
to the console
would confirm this. We have the following:
console.log(Username);
// => John Doe
console.log(rest);
// => { age: 35, sex: 'M', dob: Mon Jan 01 1990 00:00:00 GMT-0800 (PST) }
Side Note
You may wonder:Why go through the trouble of pulling off the
component
property only to rename itComponent
with a capital letter "C"?
Yeah, it seems pretty trivial. And, while it is a standard React practice, there's a reason all of Facebook's documentation on its framework is written as such. Namely, capitalizing custom components rendered with JSX is less a practice per se than it is a necessity. React, or more properly, JSX is case-sensitive. Custom components inserted without a capitalized first letter are not rendered to the DOM. This is just how React has defined itself to identify custom components. Thus, had the example not additionally renamed the component
property that was pulled off of props
to Component
, the <component {...props} />
expression would fail to render properly.
It allows you to "spread" all your props
in a single concise expression. For example, let's assume the props
received by your PrivateRoute
component looks like
// `props` Object:
{
thing1: 'Something',
thing2: 'Something else'
}
If you wanted to further hand off these items (i.e., thing1
and thing2
) down to the nested <Component />
tag and you weren't familiar with the object spread syntax, you might write:
<Component
thing1={ props.thing1 }
thing2={ props.thing2 } />
However, the { ...props }
syntax obviates such verbosity by allowing you to spread your props
object in the same way one might spread an array of values (e.g., [...vals]
). In other words, the JSX expression below and that above are exactly equivalent.
<Component { ...props } />
Lets keep it simple: in JavaScript, if a "key: value" pairs are the same,
obj={account:account}
is the same as obj={account}
. So when passing props from parent to child component:
const Input = ({name,label,error, ...rest}) => {
return (
<div className="form-group">
<label htmlFor={name}>{label}</label>
<input
{...rest}
autoFocus
name={name}
id={name}
className="form-control"
aria-describedby="emailHelp"
/>
</div>
);
};
export default Input;
you will be passing rest of props as:
label={label} placeholder={placeholder} type={type}