This tutorial aims to teach you the best practices for designing React components. We will cover how to keep your components concise, how to use props and state effectively, and other beneficial practices.
By the end of this tutorial, you should be able to:
- Understand how to design small, focused components
- Use props and state effectively in React
- Apply best practices in your component design
Basic knowledge of JavaScript and React.js is required. Familiarity with ES6 syntax (like arrow functions and destructuring) would be beneficial but not mandatory.
React components are more maintainable and understandable when they are small and focused on a single responsibility. A good rule of thumb is: if a component starts to feel complex, it's likely a good candidate for a breakdown into smaller child components.
Best Practice: One component should do one thing. If it grows, it should be decomposed into smaller subcomponents.
Props allow you to pass data from parent to child components. They help keep components reusable and decoupled.
Best Practice: Always make sure to define propTypes
and defaultProps
.
Think carefully before adding a state to a component. States bring complexity and should be used sparingly.
Best Practice: Do not duplicate data from props in state. This can lead to bugs and make the component harder to understand.
// This is a simple component that only displays a message
const Message = ({ message }) => <p>{message}</p>;
Message.propTypes = {
message: PropTypes.string.isRequired,
};
In this example, the Message
component has a single responsibility: to display a message.
// Component with propTypes and defaultProps
const WelcomeMessage = ({ name }) => <p>Welcome, {name}!</p>;
WelcomeMessage.propTypes = {
name: PropTypes.string,
};
WelcomeMessage.defaultProps = {
name: 'Guest',
};
Here, propTypes
is used to document the intended types of properties passed to components. defaultProps
are used to set default values for props.
class ToggleButton extends React.Component {
state = { isToggleOn: true };
handleClick = () => {
this.setState(prevState => ({
isToggleOn: !prevState.isToggleOn
}));
}
render() {
return (
<button onClick={this.handleClick}>
{this.state.isToggleOn ? 'ON' : 'OFF'}
</button>
);
}
}
In the above example, state
is used to store the button's state and is only modified through setState
.
In this tutorial, we learned about keeping React components small and focused, using props effectively, and state management best practices. The next step is to apply these practices in your own React applications. For more advanced topics, you can look into hooks in React and state management libraries like Redux or MobX.
Exercise 1: Create a User
component that displays a user's name and age. Pass the user data as props.
Exercise 2: Expand the User
component to include a 'Show/Hide details' button. When clicked, this button should toggle the visibility of the user's age.
Solutions:
1. Solution to Exercise 1:
const User = ({ user }) => <p>{`Name: ${user.name}, Age: ${user.age}`}</p>;
User.propTypes = {
user: PropTypes.shape({
name: PropTypes.string.isRequired,
age: PropTypes.number.isRequired,
}).isRequired,
};
class UserWithToggle extends React.Component {
state = { showAge: false };
handleToggleClick = () => {
this.setState(prevState => ({
showAge: !prevState.showAge
}));
}
render() {
const { user } = this.props;
return (
<div>
<p>{`Name: ${user.name}`}</p>
{this.state.showAge && <p>{`Age: ${user.age}`}</p>}
<button onClick={this.handleToggleClick}>
{this.state.showAge ? 'Hide details' : 'Show details'}
</button>
</div>
);
}
}
In the solution to Exercise 2, we added a state showAge
to the User
component to track whether the age details should be shown. The age details visibility is toggled when the button is clicked.