Composable yra pakartotinai naudojama funkcija, kuri hermetizuoja stateful logiką naudodama Composition API. Pagal susitarimą jis pavadintas useXxx ir grąžina reaktyvią būseną ir funkcijas — suteikdama galimybę bendrinti logiką tarp komponentų be mišinių ar pasikartojimo.
{ 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>
Kiekvienas komponentas, kuris iškviečia useCounter(), gauna savo izoliuotą count — composables sukuria šviežią būseną kiekviename skambinyje, skirtingai nei bendrinti modulio lygio kintamaisi.
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 gali naudoti gyvavimo ciklo kabliukus, stebėtojus ir kitus composables — ir svarbiausia, jie hermetizuoja savo švarinimą (onUnmounted), todėl vartotojai to neturi prisiminti.
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 yra idiomatinis stateful logikos išrinkimo ir pakartotinio panaudojimo Vue 3 būdas — duomenų gauta, formos tvarkymas, pelės/slinkties sekimas, debouncing ir kt.
Jie grynai išsprendžia logikos pakartotinio panaudojimo problemą (aiškiai, be susidūrimų, komponuojama, TypeScript draugiškai), kur Vue 2 mixin'ai žlugo.
Jie yra pagrindinė priežastis, kodėl komandos priima Composition API: bendra logika tampa paprasta, testuojama funkcija, o ne išsibarsčiusi ar dubliuota koda.