Tema 12 · Dependency Injection

12. Inyección de Dependencias: provide e inject para Jerarquías Profundas

Evita el molesto prop drilling a través de múltiples niveles de componentes anidados utilizando provide en un ancestro e inject en cualquier descendiente, manteniendo la reactividad.

Superando el Prop Drilling: Inyección de Dependencias con provide / inject

Cuando una aplicación crece, es habitual tener árboles de componentes con 3, 5 o más niveles de profundidad. Si un componente nieto o bisnieto necesita datos del componente raíz, pasar esas propiedades manualmente por cada componente intermedio se convierte en una pesadilla de mantenimiento conocida como Prop Drilling. El par provide() e inject() soluciona esto de raíz.

1. ¿Cómo Funciona provide / inject?

Cualquier componente ancestro puede actuar como un proveedor de dependencias para todos sus descendientes, sin importar cuántos niveles de profundidad existan entre ellos:

  • provide('clave', valor): El ancestro declara qué dato o servicio pone a disposición de su subárbol.
  • inject('clave', valorPorDefecto): Cualquier descendiente solicita ese dato por su clave. Los componentes intermedios no necesitan saber que ese dato existe.

2. Reactividad en la Inyección y Buenas Prácticas

Si pasas un ref() o reactive() a través de provide, la reactividad se mantiene intacta: si el ancestro actualiza el valor, todos los componentes inyectados se actualizarán automáticamente en pantalla.

Patrón de Arquitectura: Proteger la Mutación con readonly()

Para evitar que cualquier componente descendiente mute el estado de forma incontrolada, se recomienda envolver el ref con readonly() y proveer una función explícita para mutarlo:

import { provide, ref, readonly } from 'vue';

const tema = ref('oscuro');
const toggleTema = () => { tema.value = tema.value === 'oscuro' ? 'claro' : 'oscuro'; };

// Provee el estado como solo lectura y la función para mutarlo:
provide('tema', readonly(tema));
provide('cambiarTema', toggleTema);

3. Uso de InjectionKey con TypeScript (Symbol)

En aplicaciones profesionales en TypeScript, para evitar colisiones de nombres de cadenas de texto y obtener autocompletado y tipado perfecto al inyectar, se utilizan símbolos tipados (InjectionKey<T>):

import type { InjectionKey, Ref } from 'vue';

// Clave única tipada exportable:
export const ClaveUsuario: InjectionKey<Ref<Usuario>> = Symbol('usuario');

⚡ Tema Global Oscuro/Claro Inyectado a través de 3 Niveles sin Prop Drilling

Componente raíz que provee el tema y componente nieto que lo inyecta directamente.

index.html
Solo lectura
<!DOCTYPE html>
<html lang="es">
<head>
  <meta charset="utf-8">
  <title>provide e inject 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;">
    <!-- Nivel 1: Ancestro Raíz -->
    <div class="d-flex justify-content-between align-items-center mb-3">
      <h5 class="fw-bold text-success mb-0">Nivel 1: Raíz (Provide)</h5>
      <span class="badge" :class="tema === 'dark' ? 'bg-dark' : 'bg-warning text-dark'">
        Tema: {{ tema.toUpperCase() }}
      </span>
    </div>

    <p class="text-secondary small">
      El estado del tema y la función <code>cambiarTema</code> se suministran con <code>provide()</code> sin pasar props por el nivel intermedio.
    </p>

    <!-- Nivel 2: Componente Intermedio (No conoce ni pasa props de tema) -->
    <contenedor-intermedio></contenedor-intermedio>
  </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, provide, inject, readonly } = Vue;

    const app = createApp({
      setup() {
        const tema = ref('dark');

        const alternarTema = () => {
          tema.value = tema.value === 'dark' ? 'light' : 'dark';
        };

        // Proporciona el tema a todo el subárbol:
        provide('temaClave', readonly(tema));
        provide('accionAlternar', alternarTema);

        return { tema };
      }
    });

    // NIVEL 2: Contenedor Intermedio (Puro contenedor, sin props)
    app.component('contenedor-intermedio', {
      template: `
        <div class="p-3 bg-white border rounded mb-2">
          <h6 class="text-secondary mb-2 small fw-bold">Nivel 2: Contenedor (Sin tocar props)</h6>
          <!-- Nivel 3: Nieto -->
          <tarjeta-perfil></tarjeta-perfil>
        </div>
      `
    });

    // NIVEL 3: Componente Nieto que inyecta directamente
    app.component('tarjeta-perfil', {
      setup() {
        // Inyecta directamente desde la raíz:
        const tema = inject('temaClave', 'light');
        const alternar = inject('accionAlternar');

        return { tema, alternar };
      },
      template: `
        <div class="p-3 rounded border" :class="tema === 'dark' ? 'bg-dark text-white' : 'bg-light text-dark'">
          <div class="d-flex justify-content-between align-items-center">
            <div>
              <h6 class="mb-0 fw-bold">Nivel 3: Nieto (Inject Directo)</h6>
              <small class="opacity-75">Recibió el tema directamente desde la raíz.</small>
            </div>
            <button @click="alternar" class="btn btn-sm btn-primary">
              Alternar
            </button>
          </div>
        </div>
      `
    });

    app.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
¿Cuál es el beneficio de usar provide e inject en lugar de pasar props a través de 5 niveles de componentes intermedios?
🦉
¿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.