Composables e utilitários

useReducedMotion

Composable / módulo

Ref que acompanha `prefers-reduced-motion: reduce`. Use para desligar ou encurtar animações.

Importação
import { useReducedMotion, isMotionDisabled } from 'vueui-nova-kit'

Uso

O valor só sincroniza no cliente (onMounted). isMotionDisabled(level, reduced) é um atalho: retorna true quando o nível do componente é none ou quando o usuário pediu movimento reduzido.

Exemplo
<script setup lang="ts">
import { useReducedMotion, isMotionDisabled } from 'vueui-nova-kit'

const reduced = useReducedMotion()
const skip = isMotionDisabled('default', reduced.value)
</script>

Retorno

NomeTipoDescrição
(retorno de useReducedMotion)Ref<boolean>True quando o sistema pede movimento reduzido.
isMotionDisabled(level: 'default' | 'expressive' | 'none', reduced: boolean) => booleanCombina o nível de motion do componente com a preferência do usuário.

Demo

Exemplo ao vivo usando o próprio composable ou módulo, com componentes da lib.

API

useReducedMotion

Observa a media query prefers-reduced-motion e devolve um Ref<boolean>.

ts
useReducedMotion()
isMotionDisabled

True se o nível for none ou se reduced for true.

ts
isMotionDisabled(level: 'default' | 'expressive' | 'none', reduced: boolean): boolean

Fonte: src/composables/useReducedMotion.ts