Een composable is een herbruikbare functie die stateful logic inkapselt met behulp van de Composition API. Volgens afspraak heet het useXxx en retourneert het reactieve state plus functies — waardoor je logica kunt delen tussen componenten zonder mixins of herhaling.
{ ref, computed } ;
() {
count = (initial);
double = ( count. * );
() { count.++; }
() { count. = initial; }
{ count, double, increment, reset };
}
<script setup>
import { useCounter } from "@/composables/useCounter";
const { count, double, increment } = useCounter(10); // each call = independent state
</script>
<template>
<button @click="increment">{{ count }} (double: {{ double }})</button>
</template>
Elk component dat useCounter() aanroept, krijgt zijn eigen geïsoleerde count — composables creëren per oproep een frisse state, in tegenstelling tot een gedeelde module-level variabele.
import { ref, onUnmounted } from "vue";
export function useMousePosition() {
const x = ref(0), y = ref(0);
const update = (e) => { x.value = e.pageX; y.value = e.pageY; };
window.addEventListener("mousemove", update); // set up
onUnmounted(() => window.removeEventListener("mousemove", update)); // auto cleanup!
return { x, y };
}
Composables kunnen lifecycle hooks, watchers en andere composables gebruiken — en wat cruciaal is, ze verkapselen hun eigen cleanup (onUnmounted), dus consumenten hoeven het niet te onthouden.
Mixins (Vue 2): merged into the component — unclear where properties came from,
naming collisions between mixins, implicit dependencies
Composables: explicit imports + return values — clear sources, no collisions,
can be composed, fully typed in TypeScript
Composables zijn de idiomatische manier om stateful logic uit te pakken en opnieuw te gebruiken in Vue 3 — data fetching, formulierverwerking, mouse/scroll tracking, debouncing, enz.
Ze lossen het probleem van logica-hergebruik schoon op (expliciet, botsingvrij, samenstellbaar, TypeScript-vriendelijk) waar Vue 2's mixins faalden.
Ze zijn de primaire reden waarom teams de Composition API adopteren: gedeelde logica wordt een eenvoudige, testbare functie in plaats van verspreide of gedupliceerde code.