In this article we are going to learn about useEffect vs useLayoutEffect.
Introduction
II. useEffects
III. useLayoutEffect
- What is
useLayoutEffect
- Syntax
- Example: using
useLayoutEffect
to synchronise DOM changes - Clean Up function in
useLayoutEffect
- Dependency array in
useLayoutEffect
IV. Difference between useLayoutEffect and useEffect
V. Examples: When to use useEffect and useLayoutEffect
- Example 1: Updating the DOM based on a state change
- Example using
useEffect
- Example using
useLayoutEffect
- Example 2: Updating the DOM and Measuring the DOM
- Example using
useEffect
- Example using
useLayoutEffect
- Example 3: Fetching user data with useEffect
- Example 4: Sync the height of 2 elements with the help of useLayoutEffect
VI. Best Practices and When to use useLayoutEffect
and useEffect
- When to choose
useLayoutEffect
anduseEffect
- Tips for optimizing performance
- Common mistakes and how to avoid them
VII. Conclusion
- Thank you for reading
React Hooks: An Introduction
React hooks are simple JavaScript functions that enable developers to use state and other react features in functional components
They encapsulate re-useable code in functions, that can be added in components to introduce functionality that was previously available in class components into functional components
Some common hooks include useState
, useEffect
, useContext
and useLayoutEffect
The hooks enable developers to handle side effects, manage local state and read and access context
This article is provided by DeadSimpleChat Chat API for your website and app
By using Hooks developers can create more readable, concise and maintainable codebase
Side Effects in React : useEffect and useLayoutEffect
Components need to syncronize with external systems, like setting up a server connection, controlling an external library based on react state etc
Here are some of the reasons why managing side effects is important in react
- Ability to predict and mantain code: Properly handling effects results in fewer bugs and more reliable code, thus app behaves predictably and it is easier to maintain as well
- Ability to Optimize performance: Proper management of effects results in opmization of performance and resource utlization
- Cleanup functionality: With proper effects hook you can easily write the code to clean up as well after the effects have taken place
- Synchronization: With effects hooks you can synchronize component lifecycle events with effects.
useEffect
and useLayoutEffect
are two react hooks that provide a way to perform side effects, sync with component lifecycle and clean up after the effect has taken place
useEffect
useEffect is a hook that lets you handle side effects in react.
Components need to connect to the network, call an api or sync with a third party library or other asynchronous operations.
All of these are not controlled by react and hence are called external systems
useEffect
is used to connect, sync and control external systems. useEffect
runs after the component has rendered on the screen and it can be setup to re run on every render or when some dependencies change
useLayoutEffect
useLayoutEffect
is similar to useEffect but it runs synchronously after all the DOM but before the browser has rendered anything on the screen
You can use this hook to measure or manipulate the DOM and want to ensure the changes are made before the browser repaints
Understanding useEffect
React useEffect
is a react hook that lets you perform side effects in react. With useEffect you can connect to external systems like connect to the network or server, a third party library.
Syntax and Basic usage
useEffect(() => {
// write logic to handle side effect like callling an API /connecting to a server or connecting to a third party library here
return () => {
// You can create a cleanup function to clean up after the effect has taken place
};
}, [dependencyA, dependencyB]);
useEffect
has the following
- A function that contains the logic to handle side effect
- An optional dependency array, that has dependencies listed, When the dependencies change the they trigger the effect
- An optional cleanup function that cleans up after the effect has taken place
Example: Fetching data with useEffect
In this example we are going to fetch some data using an API and the useEffect hook
import React, { useState, useEffect } from 'react';
function GetDetails() {
const [data, setData] = useState([]);
const [loading, setLoading] = useState(true);
useEffect(() => {
async function getInfo() {
const response = await fetch('https://jsonplaceholder.typicode.com/todos/1');
const data = await response.json();
setData(data);
setLoading(false);
}
getInfo();
}, []); // If you want the code to run only once when mounted leave the dependency array empty
return (
<div>
{loading ? <p>searching...</p> : <ul>{data.map(item => <li key={item.id}>{item.title}</li>)}</ul>}
</div>
);
}
Clean Up function
As I have already stated the clean up function is an optional function that can be returned from the useEffect
It is used to perform clean up after the effect has taken place, this might include unsubcribing from events, releasing resources.
Here is an example of of using a clean up function to unsubscribe from a websocket connection
Dependency Array
It is an optional second argument in useEffect. It is an array of dependencies, when these dependencies change it triggers a re run of the effects
If the an empty array is provided the effect will run only once when the component mounts
If the array is omitted then the effects run everytime the component is rendered
let us consider an example:
uselayoutEffect
useLayoutEffect
is a react hook similar to useEffect
with function that has a the side effect logic, a dependency array and an optional callback function can be returned as well
The difference between useLayoutEffect and useEffect is that useLayoutEffect
runs synchronously after all the DOM mutations and before the browser repaints
This hook can be used to measure and manipulate the DOM and when we want to ensure that the changes have been made before the browser repaints. This involves use-cases which might cause flickering or layout jumps
The useLayoutEfffect
should be used when necessary because it can cause performance issues, because of its syncronous nature
Syntax
useLayoutEffect
has a similar syntax as useEffect
useLayoutEffect(() => {
// Some effect logic goes here
return () => {
// optional clean up function
};
}, [dependencyA, dependencyB]);
Example: using useLayoutEffect to synchronise DOM changes
In this example we are going to update the position of the tooltip based on the position of the target element
In this example we are using the useLayoutEffect
to update the tooltip's position with respect to the target element
Clean Up function in useLayoutEffect
Clean up function is exactly similar to the useEffect, so you can just reference it in from above. Just replace useEffect
with useLayoutEffect
Dependency array in useLayoutEffect
Dependency Array is exactly similar to the useEffect, so you can just reference it in from above. Just replace useEffect
with useLayoutEffect
Difference between useLayoutEffect and useEffect
Asynchronous vs synchronous timing of execution
The core difference between useLayoutEffect and useEffect is the timing of execution of code
while the useEffect is asynchronous the useLayoutEffect is synchronous
useEffect
: The useEffect runs after the component has been rendered and is a asynchronous hook, primarily used to handle external systems like api calls or integration with third party libraryuseLayoutEffect
: The useLayoutEffect is an synchronous hook, that runs after all the DOM mutations but before the browser layout. It is mainly used for UI and it may cause performance issues as it blocks the browser from painting the UI untill the effects have taken place. It is used to avoid issues like flickerring or jumps in the UI
Use-Case for useLayoutEffect and useEffect
Here are some of the common use-cases for both of these hooks
useEffect
- Connecting to a remote servert
- Fetching data from an API
- Updating the state in response to prop changes
- connecting to external third party libraries
- Performing other asynchronous operations
useLayoutEffect
- When state changes updating the DOM
- Preventing flickering or UI Jumps during DOM manipulations
- Sync DOM changes with other components or UI elements
Examples: When to use useLayoutEffect and when to use useEffect
Example 1: Updating the DOM based on state changes
useEffect
In this example we have a component that displays a list of items and a toggle button to show/ hide the visibility of the list
We can use useEffect to update the visibility of the list based on the state changes
import React, { useState, useEffect } from 'react';
function TogglableList() {
const [isVisible, setIsVisible] = useState(true);
useEffect(() => {
const listElement = document.getElementById('user-list');
if (isVisible) {
listElement.style.display = 'block';
} else {
listElement.style.display = 'none';
}
}, [isVisible]);
return (
<div>
<button onClick={() => setIsVisible(!isVisible)}>Show / Hide list</button>
<ul id="user-list">
{/* List of items goes here */}
</ul>
</div>
);
}
Here we are using the useEffect
to update the show/hide property of the list using the isVisible
state
Here is DOM update is not critical to the calculations of layout or to asynchronous operation with useEffect
hook
useLayoutEffect
Now, let us consider an example where visibility changes require a synchronous operation and we need to use useLayoutEffect
Consider a component that measures the height of a panel that can collapse and we are animating the height based on the isExpanded
state
Here we are using the useLayoutEffect because the useLayoutEffect
synchronously updates the height of the panel before the browser paints
We need the height update to be made synchronously because otherwise it would break the UI for a little time and that would be a bad experience for the user.
In short, where the UI would break we need synchronous effect resolution thus we use useLayoutEffect
other wise we use useEffect
Example 2: Updating the DOM and Measuring the DOM
We are considering an example where we will measure the DOM and update the DOM based on the measurements
useEffect
We have a component which displays a notification, we need to center it horizontally in the screen.
We can use useEffect
to measure the length of the notification bar and update its position to center it on the screen
In this example we are using useEffect
to measure the width of the toast notification based on the width of the screen.
Since measurement and updating the position are not critical to rendering the UI on the page we can use useEffect
to manage this.
useLayoutEffect
In this example we have a tolltip next to an input field, and we want to ensure that the tooltip is propperly positioned before the browser repaints
import React, { useRef, useLayoutEffect } from 'react';
function InputTooltip({ textOfTooltip }) {
const inputRef = useRef();
const tooltipRef = useRef();
useLayoutEffect(() => {
const inputRect = inputRef.current.getBoundingClientRect();
const tooltipRect = tooltipRef.current.getBoundingClientRect();
tooltipRef.current.style.left = `${inputRect.right + 20}px`;
tooltipRef.current.style.top = `${inputRect.top + (inputRect.height - tooltipRect.height) / 2}px`;
}, [TextOfTooltip]);
return (
<div>
<input ref={inputRef} type="text" />
<div ref={tooltipRef} className="tooltip">
{textOfToolTip}
</div>
</div>
);
In this example we are using useLayoutEffect
to synchronously position the tooltip next to the input field
We are using useLayoutEffect
because we need the tooltip exactly next to the input field when the page renders on the screen, if the tooltip comes at a later point in time it might cause issues like UI jumps.
Example 3: Fetching user data with useEffect
We are building a component that fetches the user data from an API when the component mounts
import React, { useState, useEffect } from 'react';
function UserProfile({ userId }) {
const [userData, setUserData] = useState(null);
const [loading, setLoading] = useState(true);
useEffect(() => {
async function fetchData() {
const response = await fetch(`https://jsonplaceholder.typicode.com/users`);
const data = await response.json();
setUserData(data);
setLoading(false);
}
fetchData();
}, [userId]);
return (
<div>
{Searching ? (
<p>Searching...</p>
) : (
<div>
<h1>{userData.name}</h1>
<p>Email: {userData.email}</p>
{/* list of user details here */}
</div>
)}
</div>
);
}
Here we are using the useEffect
to fetch the user data from the JSON placeholder website and render it when the component mounts.
We have also added userId as a dependency, so when ever the userId gets upadated the effects run again thus calling the API again to update the user details
we are also displaying the user data or a seaching indicator based on the state of the component at that point in time
Example 4: Sync the height of 2 elements with the help of useLayoutEffect
We have 2 elements on a page and we want to make their heights in sync with each other such that they are always equal
import React, { useRef, useLayoutEffect } from 'react';
function InSyncHeight({ leftColumn, rightColumn }) {
const leftRef = useRef();
const rightRef = useRef();
useLayoutEffect(() => {
const leftHeight = leftRef.current.offsetHeight;
const rightHeight = rightRef.current.offsetHeight;
if (leftHeight > rightHeight) {
rightRef.current.style.height = `${leftHeight}px`;
} else {
leftRef.current.style.height = `${rightHeight}px`;
}
}, [leftColumn, rightColumn]);
return (
<div className="InSyncHeight">
<div ref={leftRef} className="column-left">
{leftColumn}
</div>
<div ref={rightRef} className="column-right">
{rightColumn}
</div>
</div>
);
}
Here we are using useLayoutEffect
to measure the height of both the colums and then set the height of the smaller column to match the height of the taller column
we have also added both the column variables in the dependency array such that whenver the height of any of these colums changes then the useLayoutEffect will run again
Best Practices and When to use useLayoutEffect
and useEffect
When to choose useLayoutEffect and useEffect
useEffect
runs asynchronous and does not cause any performance issues and thus should be the default choice whenever you want to deal with external systems such as
- calling an API
- updating DOM based on state changes
- connecting with a remote server
- connecting with third party library
Only for things that might cause an UI issue such as flickerring or UI jumps if the operation or connection with the external system is performed asynchronously then useLayoutEffect
should be used
use the useLayoutEffect
in the following scenarios
- When measuring or manipulating the DOM you need to make sure that Changes are made before the browser repaints
- Effects must be in sync with the component rendering to avoid momentary breaks in UI rendering.
Tips for optimizing performance
- use the dependency array to control when the effects runs
- Avoid performance resource intensive tasks in
useLayoutEffect
as this would slow down the UI rendering, whenever the effect re runs - Properly run the clean up function when the effects have run. As not performing proper clean up might result in bugs or memory leaks
- Try to encapsulte complex logic in custom hooks
Common mistakes and how to avoid them
- Not managing the dependency Array : Remember these points with regards to the dependency array
Always state the reactive values in the dependency array, when reactive values change the effect will re run
Leaving the dependency array empty will result in the effect running only once when the component mounts
Not providing the dependency array results in the effects running every time the component re runs
2. Overusing useLayoutEffect
Only use the useLayoutEffect
where it is nessessory, defaulting to useEffect
whenever possible. As useLayoutEffect
is synchronous it may cause performance issues and it is render blocking as well. So, to avoid performance issues always default to useEffect
3. Always list reactive values in dependency array
Whenever you are using component values that are reactive, always list them in the dependency array. This ensures that whenever these vaulues change the effect will run
4. Not running the clean up function properly or not running the clean up function at all
Clean up function is an important part of the effects, after the effects have taken place always free up the resources and clean up. Not doing the clean up properly may cause bug or memory leaks
You might be interested in some of our other articles
- React useEffect: A complete guide with examples
- useCallback: Guide, use-cases, examples
- React useDeferredValue
- React useMemo Vs useCallback
Conclusion
I hope you liked the article. Thank you for reading.
This article is brought to you by DeadSimpleChat, Chat API for your website and app