Composables e utilitários
useSpringValue
Composable / módulo
Anima um número até o alvo com uma mola amortecida (`springStep`). Respeita `useReducedMotion` e pode pular a transição com `immediate`.
import { useSpringValue } from 'vueui-nova-kit'Uso
Passe um Ref<number> como alvo. O retorno value é o número interpolado; jump vai ao valor sem animar; start retoma o loop. Ajuste stiffness (padrão 180) e damping (18) se precisar de outra curva.
<script setup lang="ts">
import { ref } from 'vue'
import { useSpringValue, VButton } from 'vueui-nova-kit'
const target = ref(24)
const { value } = useSpringValue(target)
</script>
<template>
<VButton @click="target = target === 24 ? 80 : 24">Alternar</VButton>
<div :style="{ width: value + '%' }" />
</template>Retorno
| Nome | Tipo | Descrição |
|---|---|---|
value | Ref<number> | Valor interpolado da mola. |
jump | (next: number) => void | Define o valor imediatamente, cancelando o frame em curso. |
start | () => void | Reinicia a animação em direção ao alvo atual. |
Demo
Exemplo ao vivo usando o próprio composable ou módulo, com componentes da lib.
API
useSpringValueObserva um Ref alvo e anima um valor com mola, pulando a transição se o movimento reduzido estiver ativo.
useSpringValue(target: Ref<number>, options: { stiffness?: number; damping?: number; immediate?: boolean } = {}) Fonte: src/composables/useSpringValue.ts