10. Comunicación Padre-Hijo: defineProps Tipados y defineEmits
Implementa el principio unidireccional de datos en Vue: pasa parámetros hacia abajo mediante defineProps con validación o tipado TypeScript, y emite eventos hacia arriba con defineEmits.
El Flujo Unidireccional de Datos: Props Down, Events Up
Para mantener las aplicaciones predecibles y fáciles de depurar, Vue implementa el principio de flujo unidireccional de datos (One-Way Data Flow): los datos viajan hacia abajo desde los padres hacia los hijos mediante Props, y las intenciones de cambio viajan hacia arriba mediante Eventos Emitidos (Emits).
Figura 10.1: Arquitectura de datos: comunicación jerárquica con props/emits y desacoplamiento global con Pinia.
1. defineProps(): Paso de Datos Hacia Abajo
En <script setup>, defineProps() es una macro de compilación que no requiere importación. Permite definir el contrato de datos esperado por el componente hijo:
- Sintaxis con TypeScript Puro:
const props = defineProps<{ titulo: string; precio: number; destacado?: boolean; }>(); - Sintaxis con Validación en Tiempo de Ejecución (JavaScript):
const props = defineProps({ titulo: { type: String, required: true }, precio: { type: Number, default: 0 } });
Regla Sagrada: Las Props son de Solo Lectura (Inmutables)
Un componente hijo NUNCA debe mutar directamente una prop recibida (ej: props.precio = 100). Modificar una prop desde el hijo causará una advertencia de Vue en consola y generará estados inconsistentes e imposibles de rastrear. Si el hijo necesita cambiar el dato, debe emitir un evento hacia el padre.
2. defineEmits(): Notificación de Eventos Hacia Arriba
El hijo declara los eventos que es capaz de disparar utilizando defineEmits(), enviando una carga útil (payload) opcional:
// Declaración del emit en el hijo:
const emit = defineEmits<{
(e: 'actualizar-precio', nuevoPrecio: number): void;
(e: 'eliminar', id: number): void;
}>();
// Disparo del evento ante una acción del usuario:
function alPresionarBoton() {
emit('actualizar-precio', 250);
}
En el componente padre, se escucha como cualquier evento estándar: <ComponenteHijo @actualizar-precio="guardarNuevoPrecio" />.
⚡ Comunicación Padre-Hijo en Tiempo Real con Props y Emits
Componente padre que distribuye productos y componente hijo que emite eventos de compra.
<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="utf-8">
<title>Props y Emits 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;">
<!-- COMPONENTE PADRE -->
<div class="d-flex justify-content-between align-items-center mb-3">
<h5 class="fw-bold text-success mb-0">Tienda de Libros (Padre)</h5>
<span class="badge bg-primary fs-6">Total Pedido: \${{ saldoTotal }}</span>
</div>
<p class="text-secondary small">
El padre envía cada libro al hijo vía <code>:libro="item"</code>. El hijo notifica al padre vía <code>@comprar="sumarPedido"</code>.
</p>
<!-- RENDERIZADO DE COMPONENTES HIJOS -->
<div class="vstack gap-2 mb-3">
<tarjeta-libro
v-for="libro in catalogo"
:key="libro.id"
:titulo="libro.titulo"
:precio="libro.precio"
:stock="libro.stock"
@comprar="procesarCompra(libro.id)"
></tarjeta-libro>
</div>
<div v-if="ultimoComprado" class="alert alert-success py-2 small mb-0">
✓ Última compra: <strong>{{ ultimoComprado }}</strong>
</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;
const app = createApp({
setup() {
const saldoTotal = ref(0);
const ultimoComprado = ref('');
const catalogo = ref([
{ id: 1, titulo: 'Vue 3 & Composition API', precio: 30, stock: 5 },
{ id: 2, titulo: 'TypeScript para Arquitectos', precio: 45, stock: 3 },
{ id: 3, titulo: 'Patrones de Diseño en Frontend', precio: 50, stock: 0 }
]);
const procesarCompra = (id) => {
const item = catalogo.value.find(l => l.id === id);
if (item && item.stock > 0) {
item.stock--;
saldoTotal.value += item.precio;
ultimoComprado.value = `${item.titulo} (\${item.precio})`;
}
};
return {
saldoTotal,
ultimoComprado,
catalogo,
procesarCompra
};
}
});
// COMPONENTE HIJO DECLARADO
app.component('tarjeta-libro', {
props: {
titulo: { type: String, required: true },
precio: { type: Number, required: true },
stock: { type: Number, required: true }
},
emits: ['comprar'],
template: `
<div class="p-3 bg-white border rounded d-flex justify-content-between align-items-center">
<div>
<h6 class="mb-0 fw-bold">{{ titulo }}</h6>
<div class="small text-muted">
Precio: \${{ precio }} |
<span :class="stock > 0 ? 'text-success' : 'text-danger fw-bold'">
{{ stock > 0 ? 'Disponibles: ' + stock : 'Agotado' }}
</span>
</div>
</div>
<button
@click="\$emit('comprar')"
:disabled="stock === 0"
class="btn btn-sm"
:class="stock > 0 ? 'btn-outline-success' : 'btn-outline-secondary'"
>
{{ stock > 0 ? 'Comprar' : 'Sin Stock' }}
</button>
</div>
`
});
app.mount('#app');
</script>
</body>
</html>
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Por qué un componente hijo nunca debe modificar directamente una propiedad recibida en defineProps()?
¿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.