useMediaQuery

Category

Browser

Export Size

505 B

Last Changed

yesterday

Reactive Media Query. Once you've created a MediaQueryList object, you can check the result of the query or receive notifications when the result changes.

Demo

source

isLargeScreen: false
prefersDark: false

Usage

import { useMediaQuery } from '@vueuse/core'

const isLargeScreen = useMediaQuery('(min-width: 1024px)')
const isPreferredDark = useMediaQuery('(prefers-color-scheme: dark)')

Type Declarations

/**
 * Reactive Media Query.
 *
 * @see https://vueuse.org/useMediaQuery
 * @param query
 * @param options
 */
export declare function useMediaQuery(
  query: MaybeRefOrGetter<string>,
  options?: ConfigurableWindow,
): ComputedRef<boolean>

Source

Source • Demo • Docs

Contributors

Anthony Fu

Antério Vieira

Alex

Anthony Fu

Indrek Ardel

Zhousg

Young

Jelf

Dominik Freier

webfansplz

Eureka

karma

Alex Kozack

Jacob Clevenger

Changelog

Pending for release...

3af75 - fix: the return value should be computed (#4403)

v12.0.0-beta.1 on 11/21/2024

0a9ed - feat!: drop Vue 2 support, optimize bundles and clean up (#4349)

v10.3.0 on 7/30/2023

f3969 - fix: only add/remove event listeners on query change (#3236)

v10.0.0-beta.4 on 4/13/2023

4d757 - feat(types)!: rename MaybeComputedRef to MaybeRefOrGetter

10e98 - feat(toRef)!: rename resolveRef to toRef

v10.0.0-beta.3 on 4/12/2023

4e7b0 - fix(useWindowSize)!: use media query instead of orientationchange listener (#2919)