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`.

Importação
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.

Exemplo
<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

NomeTipoDescrição
valueRef<number>Valor interpolado da mola.
jump(next: number) => voidDefine o valor imediatamente, cancelando o frame em curso.
start() => voidReinicia 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

useSpringValue

Observa um Ref alvo e anima um valor com mola, pulando a transição se o movimento reduzido estiver ativo.

ts
useSpringValue(target: Ref<number>, options: { stiffness?: number; damping?: number; immediate?: boolean } = {})

Fonte: src/composables/useSpringValue.ts