11. Slots Avanzados: Slots por Defecto, Nombrados y Scoped Slots (v-slot)
Diseña componentes altamente componibles y reutilizables mediante ranuras de contenido (slots), slots nombrados (#header, #footer) y scoped slots para compartir datos del hijo hacia la plantilla del padre.
Composición Extensible: Distribución de Contenido con Slots
Mientras que las props permiten inyectar datos (números, strings, arrays), los Slots (Ranuras) permiten al componente padre inyectar fragmentos completos de plantilla HTML y otros componentes dentro del hijo. Esto permite crear componentes de interfaz sumamente flexibles como tarjetas, modales o tablas personalizables.
1. Slot por Defecto y Contenido de Respaldo (Fallback)
En el hijo, la etiqueta <slot></slot> define dónde se proyectará el contenido enviado por el padre. Si el padre no envía nada, Vue muestra el contenido por defecto colocado dentro de la etiqueta:
<!-- ComponenteBoton.vue (Hijo) -->
<button class="btn btn-primary">
<slot>Texto por defecto si el padre no envía nada</slot>
</button>
2. Slots Nombrados (Atajo #)
Cuando un componente necesita múltiples ranuras estructuradas (por ejemplo una cabecera, un cuerpo y un pie de página), se les asigna un atributo name:
<!-- En el Padre: usando v-slot:nombre o su atajo #nombre -->
<VentanaModal>
<template #header>
<h4>Confirmar Eliminación</h4>
</template>
<template #default>
<p>¿Estás seguro de que deseas eliminar este registro permanentemente?</p>
</template>
<template #footer>
<button class="btn btn-danger">Eliminar</button>
</template>
</VentanaModal>
3. Scoped Slots (Ranuras con Alcance): Compartir Datos del Hijo al Padre
Normalmente el padre no puede ver las variables internas del hijo. Los Scoped Slots permiten al hijo enviar datos hacia arriba a través de la ranura para que el padre decida cómo renderizarlos:
<!-- En el Hijo: pasa datos al slot como props -->
<slot :usuario="usuarioActual" :esAdmin="true"></slot>
<!-- En el Padre: recibe los datos mediante destructuring -->
<ListaUsuarios v-slot="{ usuario, esAdmin }">
<span>{{ usuario.nombre }} ({{ esAdmin ? 'Administrador' : 'Invitado' }})</span>
</ListaUsuarios>
⚡ Modal y Lista con Slots Nombrados y Scoped Slots
Componente genérico con ranuras personalizadas por el consumidor.
<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="utf-8">
<title>Slots 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: 550px;">
<h5 class="fw-bold text-success mb-3">Composición Avanzada con Slots</h5>
<!-- Uso del componente TarjetaElegante con slots nombrados -->
<tarjeta-elegante>
<!-- Slot #header -->
<template #header>
<span class="badge bg-success">Activo</span>
<span class="fw-bold text-dark">Panel de Configuración</span>
</template>
<!-- Slot #default (cuerpo) -->
<template #default>
<p class="mb-0 text-secondary small">
Este contenido HTML fue inyectado dinámicamente desde el padre utilizando ranuras estructuradas.
</p>
</template>
<!-- Slot #footer -->
<template #footer>
<button class="btn btn-sm btn-outline-success">Guardar Ajustes</button>
</template>
</tarjeta-elegante>
<!-- Uso del componente ListaGenérica con scoped slot -->
<h6 class="fw-bold text-secondary mt-4 mb-2">Lista con Scoped Slot (#item):</h6>
<lista-articulos :items="productos">
<!-- El padre decide cómo renderizar cada producto -->
<template #item="{ elemento }">
<div class="d-flex justify-content-between align-items-center w-100">
<strong>{{ elemento.nombre }}</strong>
<span class="badge bg-primary">\${{ elemento.precio }}</span>
</div>
</template>
</lista-articulos>
</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;
const app = createApp({
setup() {
const productos = ref([
{ id: 1, nombre: 'MacBook Pro M3', precio: 1999 },
{ id: 2, nombre: 'Monitor Dell 27"', precio: 450 },
{ id: 3, nombre: 'Silla Ergonómica', precio: 320 }
]);
return { productos };
}
});
// Componente con Slots Nombrados
app.component('tarjeta-elegante', {
template: `
<div class="card border mb-3">
<div class="card-header bg-light d-flex justify-content-between align-items-center">
<slot name="header">Cabecera por defecto</slot>
</div>
<div class="card-body">
<slot>Cuerpo por defecto</slot>
</div>
<div class="card-footer bg-white text-end">
<slot name="footer"></slot>
</div>
</div>
`
});
// Componente con Scoped Slot
app.component('lista-articulos', {
props: ['items'],
template: `
<ul class="list-group">
<li v-for="item in items" :key="item.id" class="list-group-item">
<!-- Pasa 'elemento' hacia el slot del padre -->
<slot name="item" :elemento="item">
{{ item.nombre }}
</slot>
</li>
</ul>
`
});
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 la función principal de un "Scoped Slot" en Vue 3?
¿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.