13. Composables: Patrón de Lógica Reutilizable (useCounter, useFetch)
Domina el reemplazo moderno de los mixins: encapsula lógica reactiva con estado en funciones reutilizables (composables) con convenciones de nombres, parámetros flexibles y limpieza automática.
La Mayor Fortaleza de Composition API: Los Composables
En el desarrollo frontend, con frecuencia necesitamos reutilizar lógica con estado (stateful logic) entre diferentes vistas o componentes: sincronizar datos con localStorage, escuchar coordenadas del cursor, hacer peticiones de red o gestionar temporizadores. En Vue 3, esta reutilización se implementa mediante Composables (funciones que aprovechan la Composition API).
1. Adiós Definitivo a los Mixins
En Vue 2, los Mixins eran la forma tradicional de compartir código, pero sufrían de tres problemas graves:
- Colisión de nombres: Si dos mixins definían una propiedad
datacon el mismo nombre, uno sobrescribía silenciosamente al otro. - Origen implícito de propiedades: En un componente con 4 mixins, era imposible saber de qué archivo provenía una variable reactiva o método.
- Imposibilidad de pasar parámetros dinámicos: Los mixins eran plantillas estáticas rígidas.
Los Composables resuelven todos estos problemas: son funciones puras de JavaScript que reciben argumentos, retornan exactamente lo que tú necesitas y sus propiedades se renombran fácilmente al destructurar.
2. Convenciones Oficiales de los Composables
- Nomenclatura: El nombre de la función siempre debe comenzar con el prefijo
useen camelCase (ej:useContador,useFetch,useUsuario). - Retorno Limpio: Se recomienda retornar un objeto plano con
ref()independientes para que el consumidor pueda desestructurarlo con total libertad sin perder la reactividad:return { contador, incrementar, decrementar, resetear }; - Limpieza Integrada: Un composable puede registrar sus propios hooks de ciclo de vida (como
onMountedoonUnmounted) de forma transparente para el componente que lo consume.
⚡ Composables en Acción: useContador y useCronometro en la Misma Vista
Lógica reactiva reutilizable encapsulada e instanciada de forma independiente.
<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="utf-8">
<title>Composables en Vue 3</title>
<link href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css" rel="stylesheet">
</head>
<body class="p-4 bg-light">
<div id="app" class="card shadow-sm p-4 mx-auto" style="max-width: 520px;">
<h5 class="fw-bold text-success mb-3">Patrón Composable: Lógica Reutilizable</h5>
<!-- Instancia 1 del composable useContador -->
<div class="p-3 bg-white border rounded mb-3">
<div class="d-flex justify-content-between align-items-center mb-2">
<h6 class="mb-0 fw-bold">Instancia A (Tickets):</h6>
<span class="badge bg-primary fs-6">{{ tickets.cuenta }}</span>
</div>
<div class="d-flex gap-2">
<button @click="tickets.incrementar" class="btn btn-sm btn-outline-primary">+1</button>
<button @click="tickets.decrementar" class="btn btn-sm btn-outline-secondary">-1</button>
<button @click="tickets.resetear" class="btn btn-sm btn-outline-danger">Reset</button>
</div>
</div>
<!-- Instancia 2 del mismo composable con paso de 5 -->
<div class="p-3 bg-white border rounded mb-3">
<div class="d-flex justify-content-between align-items-center mb-2">
<h6 class="mb-0 fw-bold">Instancia B (Puntos VIP - Paso 5):</h6>
<span class="badge bg-success fs-6">{{ puntos.cuenta }}</span>
</div>
<div class="d-flex gap-2">
<button @click="puntos.incrementar" class="btn btn-sm btn-outline-success">+5</button>
<button @click="puntos.decrementar" class="btn btn-sm btn-outline-secondary">-5</button>
<button @click="puntos.resetear" class="btn btn-sm btn-outline-danger">Reset</button>
</div>
</div>
<div class="alert alert-secondary py-2 small mb-0">
💡 Ambas instancias comparten la misma lógica del composable <code>useContador</code> con estados totalmente aislados.
</div>
</div>
<script src="/assets/vendor/vue/vue.global.prod.js"></script>
<script>
if (!window.Vue) {
document.write('<script src="https://cdn.jsdelivr.net/npm/vue@3/dist/vue.global.prod.js"><\/script>');
}
</script>
<script>
const { createApp, ref } = Vue;
// DEFINICIÓN DEL COMPOSABLE REUTILIZABLE:
function useContador(inicial = 0, paso = 1) {
const cuenta = ref(inicial);
const incrementar = () => { cuenta.value += paso; };
const decrementar = () => { if (cuenta.value - paso >= 0) cuenta.value -= paso; };
const resetear = () => { cuenta.value = inicial; };
return {
cuenta,
incrementar,
decrementar,
resetear
};
}
// CONSUMO DENTRO DEL COMPONENTE:
createApp({
setup() {
const tickets = useContador(1, 1);
const puntos = useContador(100, 5);
return {
tickets,
puntos
};
}
}).mount('#app');
</script>
</body>
</html>
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Por qué los Composables de Vue 3 son superiores a los antiguos Mixins de Vue 2?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar Vue.js 3 Profesional: Composition API, Script Setup, Pinia & Vite y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.