usePreferredReducedMotion

Category

Browser

Export Size

557 B

Last Changed

2 years ago

Reactive prefers-reduced-motion media query.

Demo

source

Preferred Motion:

no-preference

Usage

import { usePreferredReducedMotion } from '@vueuse/core'

const preferredMotion = usePreferredReducedMotion()

Component Usage

This function also provides a renderless component version via the @vueuse/components package. Learn more about the usage.

<template>
  <UsePreferredReducedMotion v-slot="{ motion }">
    Preferred Reduced Motion: {{ motion }}
  </UsePreferredReducedMotion>
</template>

Type Declarations

export type ReducedMotionType = "reduce" | "no-preference"
/**
 * Reactive prefers-reduced-motion media query.
 *
 * @see https://vueuse.org/usePreferredReducedMotion
 * @param [options]
 */
export declare function usePreferredReducedMotion(
  options?: ConfigurableWindow,
): ComputedRef<ReducedMotionType>

Source

Source • Demo • Docs

Contributors

Anthony Fu

丶远方

vaakian X

Zhao

Changelog

v9.11.0 on 1/17/2023

d5321 - fix(components): mark defineComponent as pure (#2623)

v9.1.0 on 8/4/2022

e808b - feat: new function (#2039)