Composables e utilitários
useReducedMotion
Composable / módulo
Ref que acompanha `prefers-reduced-motion: reduce`. Use para desligar ou encurtar animações.
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.
<script setup lang="ts">
import { useReducedMotion, isMotionDisabled } from 'vueui-nova-kit'
const reduced = useReducedMotion()
const skip = isMotionDisabled('default', reduced.value)
</script>Retorno
| Nome | Tipo | Descrição |
|---|---|---|
(retorno de useReducedMotion) | Ref<boolean> | True quando o sistema pede movimento reduzido. |
isMotionDisabled | (level: 'default' | 'expressive' | 'none', reduced: boolean) => boolean | Combina 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
useReducedMotionObserva a media query prefers-reduced-motion e devolve um Ref<boolean>.
useReducedMotion()isMotionDisabledTrue se o nível for none ou se reduced for true.
isMotionDisabled(level: 'default' | 'expressive' | 'none', reduced: boolean): boolean Fonte: src/composables/useReducedMotion.ts