"New props" arrow label is misleading

This issue has been tracked since 2019-03-10.


I realize that the phrase "New props" is in the original tweet of Dan Abramov, but "new props" is vague and misleading. Further, it tends to reinforce the misconception mentioned in Brian Vaughn's blog post that the "Updating" swimlane is triggered only when the props "change" or are "different" ( "new" props suggests "different" from "old" props). As the blog post says "these lifecycles are called any time a parent component rerenders, regardless of whether the props are 'different' from before".


Change the wording to say "parent rerenders" or something similar.


I'm not trying to be picky. Dan's diagram and your project have been infinitely helpful in aiding my understanding, yet I've continuously seen beginner, intermediate, and even some advanced React developers tripped up by this confusion. It's a small change, but if you agree, I can help out and do the PR as well.

csr632 wrote this answer on 2019-03-18

Agreed. "New props" is confusing and doesn't have any (correct) meaning. "Parent rerenders" give infomation about "why" and "when", just like the "set­State()" and "force­Update()" labels do.

stephan-noel wrote this answer on 2019-03-21

Thanks for your input @csr632 ! In the meantime, I've had a colleague suggest "nextProps". Also, maybe "parent render()" would be preferable to "parent rerenders" to clarify the possible ambiguity between the React lifecycle render() method vs. the browser rendering. Not sure if Dan has any opinion about this...

EricCoteReact wrote this answer on 2019-11-19

I feel that "parent render()" is perfect.

When I give a course, I use this wording:
Render: the method to generate the virtual DOM. (generates a tree structure of React Elements, which are simple js objects).
Reconcilation: the React process to update the DOM. (React does this by comparing the current vDOM with the previous one.)
Browser paint or Browser refresh: the browser process to show the DOM on the screen.

jeffacode wrote this answer on 2022-01-05

Totally agreed! This arrow is very misleading, which confused me for quite a long time...for correctness, as long as parent component rerenders, child components should rerender as well (not if its shouldComponentUpdate returns false)

More Details About Repo
Owner Name wojtekmaj
Repo Name react-lifecycle-methods-diagram
Full Name wojtekmaj/react-lifecycle-methods-diagram
Language JavaScript
Created Date 2018-04-05
Updated Date 2022-12-07
Star Count 3577
Watcher Count 53
Fork Count 289
Issue Count 13


Issue Title Created Date Updated Date