# useMediaQuery API

> Auto-generated API reference for `useMediaQuery` from @vuetify/v0 (Vuetify0).
> Source of truth: https://0.vuetifyjs.com/api/use-media-query

## Related

- https://0.vuetifyjs.com/composables/system/use-media-query
- https://0.vuetifyjs.com/composables/plugins/use-breakpoints
- https://0.vuetifyjs.com/composables/system/use-event-listener

## Functions

### useMediaQuery

Reactive media query matching.

```ts
(query: MaybeRefOrGetter<string>) => MediaQueryContext
```

### usePrefersDark

Check if the user prefers dark color scheme.

```ts
() => MediaQueryContext
```

### usePrefersReducedMotion

Check if the user prefers reduced motion.

```ts
() => MediaQueryContext
```

### usePrefersContrast

Check if the user prefers more contrast.

```ts
() => MediaQueryContext
```

## Methods

| Name | Type | Description |
|---|---|---|
| `stop` | `() => void` | Stop listening and clean up |

## Properties

| Name | Type | Description |
|---|---|---|
| `matches` | `Readonly<ShallowRef<boolean>>` | Whether the media query currently matches |
| `query` | `Readonly<Ref<string, string>>` | The current media query string |
| `mediaQueryList` | `Readonly<ShallowRef<MediaQueryList \| null>>` | The underlying MediaQueryList (null on server) |