On this page
useMediaQuery
Tracks media queries with named breakpoints, ranges, and pointer queries.
Overview
Copy the source into your project. Import the parts that you need. Styles use local StyleX declarations and shared theme tokens. You can change the source without a wrapper or replacement package.
Preview
Live viewport breakpoint matches
Installation
Run the init command from your project root first. The CLI configures StyleX and installs shared files and dependencies.
Run from your project root. The CLI installs required components, shared files, and packages. Previews may need additional components. The CLI keeps existing files.
Usage
Pass a named breakpoint, max-md, a range such as sm:max-lg, or a raw CSS media query. Named breakpoint widths in pixels: sm=640, md=800, lg=1024, xl=1280, 2xl=1536, 3xl=1600, and 4xl=2000.
Object queries accept min, max, and pointer (coarse or fine). Minimum widths are inclusive. Maximum widths are exclusive. Server snapshots return false. matchMedia change listeners update the client. They unsubscribe when the component unmounts or the query changes.
Import from the local file installed by the CLI.
API reference
The generator reads the component TypeScript source. Only component and Base UI props appear below. The Required column shows whether you must supply a property. It does not mean you must use the component.