Mastering React UseMediaQuery For Better Responsive Design

In the ever-evolving landscape of web development, responsive design remains a cornerstone for creating seamless user experiences across various devices. React, with its robust ecosystem, offers powerful tools to implement responsive designs efficiently. Among these tools, the useMediaQuery hook stands out as a versatile solution for handling media queries within React applications.

This blog delves deep into mastering the useMediaQuery hook, exploring its integration, customization, and best practices to elevate your responsive applications.

Understanding Media Queries in React

Media queries are pivotal in crafting responsive designs. They allow developers to apply CSS styles based on specific conditions, such as screen size, orientation, or resolution. In React, handling media queries traditionally involved writing CSS media queries or leveraging third-party libraries. However, the useMediaQuery hook offers a more integrated and dynamic approach.

What is a Media Query?

A media query is a CSS technique used to apply styles conditionally based on factors like viewport size, device type, or orientation. For instance, adjusting the layout for mobile screens versus desktop screens enhances user experience.

CSS Media Query vs. JavaScript Media Query

While CSS media queries are declarative and embedded within stylesheets, JavaScript media queries, managed through hooks like useMediaQuery, offer more flexibility. They allow React components to respond to media query matches in real-time, enabling behavior-based adjustments beyond mere styling.

Implementing the useMediaQuery Hook

The useMediaQuery hook is a custom React hook designed to monitor and respond to media query matches dynamically. It simplifies the process of integrating media queries into React components, ensuring real-time responsiveness as viewport sizes change.

Basic Usage

Here's a straightforward implementation of the useMediaQuery hook:

1import { useState, useEffect } from 'react';
2
3const useMediaQuery = (queryString, defaultValue = false) => {
4  const [matches, setMatches] = useState(defaultValue);
5
6  useEffect(() => {
7    const media = window.matchMedia(queryString);
8    if (media.matches !== matches) {
9      setMatches(media.matches);
10    }
11
12    const listener = () => setMatches(media.matches);
13    media.addEventListener('change', listener);
14
15    return () => media.removeEventListener('change', listener);
16  }, [queryString, matches]);
17
18  return matches;
19};
20
21export default useMediaQuery;

​

Using useMediaQuery in Components

Integrating the useMediaQuery hook into a React component is seamless:

1import React from 'react';
2import useMediaQuery from './useMediaQuery';
3
4const ResponsiveComponent = () => {
5  const isLargeScreen = useMediaQuery('(min-width: 1024px)');
6
7  return (
8    <div>
9      {isLargeScreen ? <LargeScreenLayout /> : <SmallScreenLayout />}
10    </div>
11  );
12};
13
14export default ResponsiveComponent;

​

In this example, the component renders different layouts based on the min-width media query.

Creating Custom React Hooks for Media Queries

While the basic useMediaQuery hook is effective, creating custom hooks tailored to specific needs can enhance functionality and reusability.

Example: useOrientation Hook

1import { useMediaQuery } from './useMediaQuery';
2
3const useOrientation = () => {
4  const isPortrait = useMediaQuery('(orientation: portrait)');
5  const isLandscape = useMediaQuery('(orientation: landscape)');
6
7  return { isPortrait, isLandscape };
8};
9
10export default useOrientation;

​

This custom hook leverages useMediaQuery to determine the device's orientation, allowing components to adjust behavior accordingly.

Handling Media Query Changes

Managing media query changes efficiently is crucial for maintaining performance and ensuring accurate responsiveness. The useMediaQuery hook incorporates event listeners to monitor changes and update the component's state in real time.

Event Listener Integration

In the useMediaQuery implementation, an event listener is added to detect changes in the media query's status:

1useEffect(() => {
2  const media = window.matchMedia(queryString);
3  if (media.matches !== matches) {
4    setMatches(media.matches);
5  }
6
7  const listener = () => setMatches(media.matches);
8  media.addEventListener('change', listener);
9
10  return () => media.removeEventListener('change', listener);
11}, [queryString, matches]);

​

This ensures that the component responds instantly to any alterations in the viewport size or other media query conditions.

Cleanup Function

To prevent memory leaks, the hook includes a cleanup function that removes the event listener when the component unmounts or the query string changes:

1return () => media.removeEventListener('change', listener);

​

Real-Time Responsiveness with useMediaQuery

Achieving real-time responsiveness enhances user experience by ensuring that the application adapts instantly to viewport changes. The useMediaQuery hook facilitates this by providing a boolean value indicating whether the media query matches, allowing components to adjust their behavior dynamically.

Example: Dynamic Styling

1import React from 'react';
2import useMediaQuery from './useMediaQuery';
3
4const DynamicStyledComponent = () => {
5  const isDarkMode = useMediaQuery('(prefers-color-scheme: dark)');
6
7  const styles = {
8    backgroundColor: isDarkMode ? '#333' : '#fff',
9    color: isDarkMode ? '#fff' : '#000',
10  };
11
12  return <div style={styles}>Hello, World!</div>;
13};
14
15export default DynamicStyledComponent;

​

In this example, the component's background and text color adapt based on the user's preferred color scheme, demonstrating real-time responsiveness.

Best Practices for Responsive Design in React

Implementing responsive design effectively requires adherence to best practices. Here are some guidelines to optimize the use of media queries and the useMediaQuery hook in React projects.

Optimize Media Query Strings

Craft precise media query strings to target specific viewport sizes or conditions. For example:

• Min Width: (min-width: 768px) targets viewports wider than 768 pixels.

• Max Width: (max-width: 1024px) targets viewports narrower than 1024 pixels.

Consolidate Media Queries

Where possible, consolidate media queries to reduce redundancy and enhance maintainability. For instance, group related media queries within custom hooks to manage similar behavior across different components.

Limit the Number of Media Queries

Excessive media queries can lead to performance issues. Aim to use only the necessary media queries that address distinct responsive design requirements.

Example: Consolidated Media Queries

1import { useMediaQuery } from './useMediaQuery';
2
3const useResponsiveDesign = () => {
4  const isMobile = useMediaQuery('(max-width: 600px)');
5  const isTablet = useMediaQuery('(min-width: 601px) and (max-width: 1024px)');
6  const isDesktop = useMediaQuery('(min-width: 1025px)');
7
8  return { isMobile, isTablet, isDesktop };
9};
10
11export default useResponsiveDesign;

​

This custom hook manages multiple media query strings, simplifying responsiveness across different screen sizes.

Enhancing React Components with useMediaQuery

Integrating the useMediaQuery hook into React components enhances their adaptability and responsiveness. By responding to media query matches, components can alter their behavior, styling, or structure based on the viewport size or other conditions.

Example: Conditional Rendering

1import React from 'react';
2import useMediaQuery from './useMediaQuery';
3
4const Navigation = () => {
5  const isMobile = useMediaQuery('(max-width: 768px)');
6
7  return (
8    <nav>
9      {isMobile ? <MobileMenu /> : <DesktopMenu />}
10    </nav>
11  );
12};
13
14export default Navigation;

​

In this scenario, the Navigation component renders different menus based on whether the viewport matches the mobile screen size.

Managing Media Query Status and Changes

Tracking the status of media queries and responding to their changes is vital for maintaining consistent responsiveness. The useMediaQuery hook provides a straightforward mechanism to monitor and react to these changes.

Monitoring Media Query Status

The hook returns a boolean value indicating whether the media query matches. This status can be used to conditionally render components or apply specific styles.

Responding to Media Query Changes

By leveraging the event listener within the useMediaQuery hook, components can update their state in response to media query changes, ensuring that the UI remains consistent with the current viewport size.

Advanced Techniques with useMediaQuery

For more complex responsive designs, advanced techniques can be employed using the useMediaQuery hook. These include combining multiple media queries, creating nested responsive components, and integrating with other hooks for enhanced functionality.

Combining Multiple Media Queries

1import React from 'react';
2import useMediaQuery from './useMediaQuery';
3
4const ComplexResponsiveComponent = () => {
5  const isWideScreen = useMediaQuery('(min-width: 1200px)');
6  const isHighResolution = useMediaQuery('(min-resolution: 2dppx)');
7
8  if (isWideScreen && isHighResolution) {
9    return <HighResWideComponent />;
10  } else if (isWideScreen) {
11    return <WideComponent />;
12  } else {
13    return <RegularComponent />;
14  }
15};
16
17export default ComplexResponsiveComponent;

​

This component adapts based on multiple media query matches, allowing for more nuanced responsiveness.

Integrating with Other Hooks

Combining useMediaQuery with other React hooks, such as useState or useEffect, can create more dynamic and interactive responsive behaviors.

The Bottom Line!

Mastering the useMediaQuery hook is instrumental in developing responsive React applications. By effectively managing media queries and their matches, developers can create adaptable and user-friendly interfaces that respond seamlessly to varying viewport sizes and conditions. Incorporating the useMediaQuery hook as a custom React hook not only simplifies the implementation of responsive design but also enhances the real-time responsiveness and behavior-based adjustments of React components. Embrace the power of useMediaQuery to elevate the responsiveness and adaptability of your React projects.

Short on time? Speed things up with DhiWise!

Tired of manually designing screens, coding on weekends, and technical debt? Let DhiWise handle it for you!

You can build an e-commerce store, healthcare app, portfolio, blogging website, social media or admin panel right away. Use our library of 40+ pre-built free templates to create your first application using DhiWise.