JavaScript for PHP Geeks: ReactJS (with Symfony)


Moving the Rep Logs to State

With a Subscription, click any sentence in the script to jump to that part of the video!

Login Subscribe

Communication always flows down in React: data lives in one component and is passed down to its children as props. Actually, both data and callbacks are passed from parent to child: child components use callbacks to communicate back up to the parent when something happens. For example, RepLogs passes an onRowClick to RepLogList. It uses that to tell its parent when that interaction occurs.

So, parents pass data to their children. But, parents do not, ask children for information. Well, it's technically possible, but it's not the normal flow.

For example, RepLogApp passes the highlightedRowId to RepLogs. But, RepLogApp does not ever ask RepLogs to give it any data that lives inside RepLogs. Information only flows down.

Why state Lives up High

For that reason, in general, we need the state of our application to live as high up the component hierarchy as possible. Why? Because we can pass a piece of state down to all of the components that need to use it. When that state changes, that change naturally flows down and everything updates beautifully.

But, imagine if a piece of state lived in a child component, but we wanted to use it in the render() method of a parent. Well, that just won't work! The parent can't ask the child for that data: information does not flow up.

This is the reason why we will put all of our state in the top level component: RepLogApp. Again, this is not an absolute rule, but it's a great rule to follow for now. We'll talk later about when it's ok to move state lower, into a child component.

Moving RepLogs to state

Anyways, the most important piece of data in our app is the rep logs themselves. And, these will need to change dynamically as the user adds new rep logs and deletes old ones. That means, rep logs need to be stored as state.

To get the static version of our app up and running, we just hardcoded these inside RepLogList. Time to move this to state! Copy the dummy rep log data and go to RepLogApp. Whenever we have new state, we need to initialize it in the constructor. Add a new repLogs key to this array and paste!

42 lines assets/js/RepLog/RepLogApp.js
... lines 1 - 5
constructor(props) {
... lines 7 - 8
this.state = {
highlightedRowId: null,
repLogs: [
{ id: 1, reps: 25, itemLabel: 'My Laptop', totalWeightLifted: 112.5 },
{ id: 2, reps: 10, itemLabel: 'Big Fat Cat', totalWeightLifted: 180 },
{ id: 8, reps: 4, itemLabel: 'Big Fat Cat', totalWeightLifted: 72 }
... lines 17 - 18
... lines 20 - 42

Yea, eventually the repLogs state will start empty, and we'll then populate it by making an AJAX call to the server for the existing rep logs. But, until then, the dummy data makes building things easier.

Passing the RepLogs State Down

The new state lives in the top-level component. But... we need to use it down in RepLogList. No problem! We just need to pass this down our tree. Fetch the repLogs out of state, then pass this as a prop to RepLogs.

42 lines assets/js/RepLog/RepLogApp.js
... lines 1 - 24
render() {
... lines 26 - 28
return (
... lines 31 - 33
... lines 38 - 42

In RepLogs, before using the new prop, head down to the bottom: we want to define all props in propTypes. Add repLogs set to PropTypes.array.isRequired.

86 lines assets/js/RepLog/RepLogs.js
... lines 1 - 79
RepLogs.propTypes = {
... lines 81 - 83
repLogs: PropTypes.array.isRequired

Copy that, because, RepLogList will receive the same prop.

30 lines assets/js/RepLog/RepLogList.js
... lines 1 - 24
RepLogList.propTypes = {
... lines 26 - 27
repLogs: PropTypes.array.isRequired,

Ok! We are passing the repLogs prop to the RepLogs component. At the top of render(), read repLogs out of props. And then, do the prop-passing dance: send this straight into RepLogList.

86 lines assets/js/RepLog/RepLogs.js
... lines 1 - 4
export default function RepLogs(props) {
const { withHeart, highlightedRowId, onRowClick, repLogs } = props;
... lines 7 - 12
return (
... lines 14 - 25
... lines 27 - 28
... lines 31 - 76
... lines 79 - 86

Finally, in that component, get repLogs out of props and... delete the hardcoded stuff.

30 lines assets/js/RepLog/RepLogList.js
... lines 1 - 3
export default function RepLogList(props) {
const { highlightedRowId, onRowClick, repLogs } = props;
... lines 6 - 22
... lines 24 - 30

This is sweet! Move back to your browser and refresh! Hey hey! It's not broken! Check out the React dev tools, and look at the top RepLogApp component. Yep! You can see the repLogs state. Now... mess with it! Change the reps from 25 to 50.... boom! The UI on the child component updates instantly!

But, look back at RepLogApp, it has two pieces of state & one prop. And... it's passing all of that into its child as props. With a trick, we can be lazier, and do this automatically.

Leave a comment!