Tema 13 · Lógica Reutilizable & Composables

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 data con 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

  1. Nomenclatura: El nombre de la función siempre debe comenzar con el prefijo use en camelCase (ej: useContador, useFetch, useUsuario).
  2. 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 };
  3. Limpieza Integrada: Un composable puede registrar sus propios hooks de ciclo de vida (como onMounted o onUnmounted) 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.

index.html
Solo lectura
<!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>
Pruébalo tú mismo » Se abre en una nueva pestaña con ejecución en vivo
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿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.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.