# useReducedMotion API

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

## Related

- https://0.vuetifyjs.com/composables/plugins/use-reduced-motion
- https://0.vuetifyjs.com/composables/system/use-media-query
- https://0.vuetifyjs.com/composables/plugins/use-theme
- https://0.vuetifyjs.com/guide/features/accessibility

## Functions

### createReducedMotion

Creates a standalone reduced-motion context.

```ts
(options?: ReducedMotionOptions) => ReducedMotionContext
```

### createReducedMotionContext

```ts
<_E>(_options?: ReducedMotionPluginOptions | undefined) => ContextTrinity<_E>
```

### createReducedMotionPlugin

```ts
(_options?: ReducedMotionPluginOptions | undefined) => Plugin
```

### useReducedMotion

```ts
<_E>(namespace?: string) => _E
```

## Options

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `mode` | `ReducedMotionMode \| undefined` | — | no | Initial mode. - `'system'` (default) — follow `prefers-reduced-motion` - `'always'` — always reduce, overrides OS setting - `'never'` — never reduce, overrides OS setting |
| `adapter` | `ReducedMotionAdapter \| undefined` | — | no | Adapter for framework-specific side-effects. Defaults to `V0ReducedMotionAdapter`. |

## Methods

| Name | Type | Description |
|---|---|---|
| `select` | `(mode: ReducedMotionMode) => void` | Set the active mode. |
| `dispose` | `() => void` | Stop the OS media-query subscription. Affects every consumer of this context; `isReduced` keeps honoring explicit `always`/`never` modes but stops tracking the OS in `system` mode. |

## Properties

| Name | Type | Description |
|---|---|---|
| `selectedMode` | `Readonly<ShallowRef<ReducedMotionMode>>` | The active mode. `'system'` defers to the OS media query. Change it with `select`. |
| `isReduced` | `Readonly<Ref<boolean, boolean>>` | `true` when motion should be minimized, considering the active `selectedMode`. |