Composable je opakovaně použitelná funkce, která zapouzdřuje stavový logic pomocí Composition API. Podle konvence se jmenuje useXxx a vrací reaktivní stav plus funkce — umožňuje vám sdílet logiku mezi komponentami bez mixinů nebo opakování.
{ 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>
Každá komponenta, která volá useCounter(), dostane svůj vlastní izolovaný count — composables vytváří nový stav při každém volání, na rozdíl od sdílené proměnné na úrovni modulu.
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 mohou používat lifecycle hooks, watchers a další composables — a zásadně zapouzdřují svou vlastní cleanup (onUnmounted), takže si ji spotřebitelé nemusí pamatovat.
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 jsou idiomatický způsob, jak extrahovat a znovu použít stavový logic v Vue 3 — načítání dat, zpracování formulářů, sledování myši/posouvání, debouncing atd.
Řeší problém opakovaného použití logiky čistě (explicitně, bez konfliktů, složitelně, TypeScript-friendly), kde Vue 2 mixiny selhaly.
Jsou to primární důvod, proč týmy přijímají Composition API: sdílená logika se stane jednoduchou, testovatelnou funkcí místo rozprostřeného nebo duplikovaného kódu.