Math functions for VueUse
This section documents version-specific API changes — prioritize recent major/minor releases.
-
DEPRECATED: and, or, not — v14 deprecated in favor of original names logicAnd, logicOr, logicNot source
-
BREAKING: Requires Vue 3.5+ — v14 moved to Vue 3.5 as minimum version, enabling native useTemplateRef and MaybeRefOrGetter source
-
BREAKING: ESM-only — v13 dropped CommonJS (CJS) support entirely source
-
NEW: useAverage — reactively calculate average from an array or variadic arguments
-
NEW: useSum — reactively calculate sum from an array or variadic arguments
-
NEW: createProjection — create a reusable numeric projector between two numeric domains
-
NEW: createGenericProjection — create a projector with a custom mapping function for arbitrary types
-
NEW: usePrecision — options now include math property for rounding strategy (floor, ceil, round)
-
NEW: useClamp — returns ComputedRef instead of Ref when input is a getter or readonly ref
-
NEW: useMath — provides reactive access to any standard Math method via key name
-
NEW: logicAnd, logicOr, logicNot — variadic reactive boolean logic supporting multiple refs
-
NEW: useMax, useMin — support both array and variadic arguments for reactive comparison
-
NEW: useAbs, useCeil, useFloor, useRound, useTrunc — dedicated reactive wrappers for common Math methods
-
NEW: useProjection — reactive numeric projection from one domain to another
-
Use useClamp with a mutable ref to create a self-validating state. When a mutable ref is passed, it returns a writable computed that automatically clamps any value assigned to it source
// Preferred: prevents invalid state assignment
const value = useClamp(shallowRef(0), 0, 10)
value.value = 15 // state remains 10
-
Pass reactive arrays for domains in useProjection to handle dynamic scaling. This is preferred for UI elements like zoomable charts or responsive sliders where the input/output boundaries change over time source
-
Define reusable mappers with createProjection outside component logic. This ensures consistent scaling across different parts of the application and reduces the overhead of redefining domains source
-
Leverage rest arguments in aggregation composables for ad-hoc calculations. useSum, , , and accept multiple refs directly, avoiding the need to create intermediate array refs
