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.