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.
<!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>
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿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.