useMediaQuery

类别

导出大小

455 B

演示

isLargeScreen: false
prefersDark: false

用法

import { useMediaQuery } from '@vueuse/core'

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

服务端渲染和 Nuxt

如果你正在使用启用 SSR 的 useMediaQuery，那么你需要指定你想要在服务端渲染和在水合之前渲染的屏幕尺寸，以避免水合不匹配

import { breakpointsTailwind, useMediaQuery } from '@vueuse/core'

const isLarge = useMediaQuery(
  '(min-width: 1024px)',
  { ssrWidth: 768 } // Will enable SSR mode and render like if the screen was 768px wide
)

console.log(isLarge.value) // always false because ssrWidth of 768px is smaller than 1024px
onMounted(() => {
  console.log(isLarge.value) // false if screen is smaller than 1024px, true if larger than 1024px
})

或者你可以使用 provideSSRWidth 为你的应用全局设置

类型声明

typescript

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