PreferenceManager: reducedMotion property

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The reducedMotion read-only property of the PreferenceManager interface returns the PreferenceObject used to override the user's preference for the reduced motion of the site.

Valid reducedMotion PreferenceObject.value settings are reduce and no-preference.

Value

A PreferenceObject used to override the user's preference for the reduced motion of the site.

Examples

Basic usage

This example demonstrates how to query the user's reduced motion preference.

js
if (navigator.preferences.reducedMotion.value === "reduce") {
  // The user prefers reduced motion.
} else {
  // The user has stated no preference regarding motion.
}

Specifications

Specification
Media Queries Level 5
# reduced-motion-attribute

Browser compatibility