learn-co-students/react-information-flow-code-along-nyc-clarke-web-100719

React Information Flow

Overview

In this lesson, we'll explore how to pass callback functions as props in order to change state in a parent component.

Objectives

1. Practice enforcing React up-down information flow
2. Practice changing state in a parent from a child component

How Does Information Flow Between Components?

We already know, how to use props to pass information down from parent to child. But how would we do the reverse? How might we have a child component send data to its parent component? In order to propagate information in the opposite direction, we can send a callback functions as a prop from the parent component to its child.

This allows the callback to be owned by a different component than the one invoking it. Once invoked, the callback can send data to or change state in the parent component that owns it, instead of the child component that invoked it.

Getting Started

Assuming you've pulled down the starter code and ran npm install and npm start, you should see a few rectangles in your browser. The large outer rectangle will be a random color every time you refresh the page, but the two smaller rectangles inside will always have a white background. Take a moment to familiarize yourself with the code base. We have a simple application that renders a single Parent component and two Child components. The component hierarchy is as followed:

App
└───Parent
    ├───Child
    └───Child

Deliverables

• When either Child component is clicked, the Parent component should change color.

src/randomColorGenerator.js has a helper function getRandomColor() implemented for you that generates a random color.

Changing the color of Parent

The Parent component has a state called color that is initially set to a random color. If we want to set the state, it would be easy to do so in an instance method like shown below:

class Parent extends Component {
  constructor() {
    super()
    this.state = {
      color: getRandomColor()
    }
  }

  changeColor = () => {
    this.setState({
      color: getRandomColor()
    })
  }

  render() {
    return (
      <div className="parent" style={{backgroundColor: this.state.color}}>
        <Child />
        <Child />
      </div>
    )
  }
}

But we are going to want to run this changeColor() method when either Child component is clicked. So we are going to pass this state changing function as a prop to both Child components.

render() {
  return (
    <div className="parent" style={{backgroundColor: this.state.color}}>
      <Child handleColorChange={this.changeColor}/>
      <Child handleColorChange={this.changeColor}/>
    </div>
  )
}

Now, Child will have a prop called handleColorChange that is a function. Specifically, it is the same function object as our Parent's 'changeColor instance method. Want to see for yourself? Put a console.log inside the render method of Child.

class Child extends Component {
  render() {
    console.log(this.props)
    return (
      <div className="child" style={{backgroundColor: "#FFF"}}></div>
    )
  }
}

What we want to do now is pass this handleColorChange prop into a React event handler.

render() {
  console.log(this.props)
  return (
    <div onClick={this.props.handleColorChange}
      className="child"
      style={{backgroundColor: "#FFF"}}
    ></div>
  )
}

And Ta-Da! Now, if you go to the app, clicking on either of the white rectangle Child components will cause the Parent component to change color! But let's add one more feature!

Deliverables

• When either Child component is clicked, it should change to its own background color to a random color, and the other Child component should change to that same color.

Now, we could put some state in our Child component to keep track of its color. However, React components cannot pass data between 'sibling' components. Data can only flow up and down between parent/child. So if we update the color of one Child component, we have no way to pass that data to the other Child component. The solution is to store the color of the Child in the state of the Parent component. Then, we let the Parent component handle the passing of that data to each of it's children components.

class Parent extends Component {
  constructor() {
    super()
    this.state = {
      color: getRandomColor(),
      childrenColor: '#FFF'
    }
  }
}

Since the data that represents the color of the two Child components lives in Parent, we should pass that data down as props:

render() {
  return (
    <div className="parent" style={{backgroundColor: this.state.color}}>
      <Child color={this.state.childrenColor} handleColorChange={this.changeColor}/>
      <Child color={this.state.childrenColor} handleColorChange={this.changeColor}/>
    </div>
  )
}

Now let's actually use that props data in the Child component

class Child extends Component {
  render() {
    return (
      <div onClick={this.props.handleColorChange}
        className="child"
        style={{backgroundColor: this.props.color}}
      ></div>
    )
  }
}

Lastly, we have to update the changeColor() method in Parent to change not just the color state, but also the childrenColor. To practice sending data back to the parent, let's change our changeColor to take in an argument of newChildColor.

changeColor = (newChildColor) => {
  this.setState({
    color: getRandomColor(),
    childrenColor: newChildColor
  })
}

Now that the function takes in an argument, we'll need to update the onClick of Child to be a function that invokes this.props.handleColorChange and passes in a random color as the argument:

class Child extends Component {
  render() {
    return (
      <div onClick={() => this.props.handleColorChange(getRandomColor())}
        className="child"
        style={{backgroundColor: this.props.color}}
      ></div>
    )
  }
}

Wow! Check out the finished product in the browser! When either Child component is clicked, the Parent changes to a random color, but also, both Child components change to a different random color.

Let's summarize:

• For information to propagate down the component tree, parents pass props to their children
• For information to propagate up the component tree, we typically invoke callbacks that were passed from parents to children as props
• Components of the same level (sibling components) cannot communicate directly! We can only communicate up and down the component tree. So if multiple components need to share the same information, that state should live in the parent (or a more general ancestor) component.