Composables e utilitários
gestures
Composable / módulo
Utilitários puros de gesto (sem DOM): resistência elástica fora do intervalo e decisão de concluir um swipe a partir do deslocamento e da velocidade.
import { rubberBand, snapFromVelocity } from 'vueui-nova-kit'Uso
Use com usePointerDrag ou com o seu próprio ponteiro. rubberBand amortece valores além de min/max; snapFromVelocity devolve se o gesto deve completar (threshold ou flick). GESTURE_DEFAULTS expõe os números padrão da lib.
import { rubberBand, snapFromVelocity, GESTURE_DEFAULTS } from 'vueui-nova-kit'
const offset = rubberBand(delta, -120, 0)
if (snapFromVelocity(-offset, velocity, GESTURE_DEFAULTS.swipeThreshold)) {
// conclui o swipe
}Retorno
| Nome | Tipo | Descrição |
|---|---|---|
rubberBand | (value, min, max, factor?) => number | Devolve o valor com resistência elástica fora de [min, max]. |
snapFromVelocity | (offset, velocity, threshold?, flick?) => boolean | Indica se o gesto deve completar, por distância ou por flick. |
GESTURE_DEFAULTS | { swipeThreshold, flickVelocity, rubberBandFactor } | Limiares padrão usados pelos componentes de swipe. |
Demo
Exemplo ao vivo usando o próprio composable ou módulo, com componentes da lib.
API
GESTURE_DEFAULTSConstantes: swipeThreshold 80, flickVelocity 0.5, rubberBandFactor 0.35.
GESTURE_DEFAULTS = { swipeThreshold: 80, flickVelocity: 0.5, rubberBandFactor: 0.35, } as construbberBandAplica um fator de resistência quando o valor sai do intervalo permitido.
rubberBand(value: number, min: number, max: number, factor = GESTURE_DEFAULTS.rubberBandFactor): numbersnapFromVelocityRetorna true se o deslocamento passa do limiar ou se a velocidade caracteriza um flick.
snapFromVelocity(offset: number, velocity: number, threshold = GESTURE_DEFAULTS.swipeThreshold, flick = GESTURE_DEFAULTS.flickVelocity): boolean Fonte: src/motion/gestures.ts