Tema 10 · Props & Emits

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).

Flujo de Comunicación Props, Emits y Pinia en Vue 3

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.

index.html
Solo lectura
<!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>
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é 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.

🏛️ 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.