Tema 3 · Directivas Principales

3. Directivas Esenciales: v-bind (:), v-model (Two-Way Binding) y v-on (@eventos)

Vincula atributos dinámicamente con v-bind, enlaza formularios reactivos bidireccionales con v-model y maneja eventos del DOM con v-on y modificadores (.prevent, .stop, .enter).

El Trío Fundamental de Directivas de Vue: Enlace, Eventos y Formularios

Las directivas son atributos especiales con el prefijo v- que aplican comportamientos reactivos al elemento del DOM. Las tres directivas más utilizadas en todo proyecto Vue son v-bind (para atributos dinámicos), v-on (para escuchar eventos) y v-model (para sincronización bidireccional en formularios).

1. Vinculación de Atributos: v-bind (Atajo :)

Los atributos HTML nativos como href, src, class, disabled o style no pueden usar bigotes {{ }}. Para ellos se utiliza v-bind o su atajo canónico ::

  • Atributo dinámico: <a :href="urlDestino">Enlace</a>
  • Atributo booleano: <button :disabled="estaCargando">Guardar</button> (si es falso o nulo, el atributo se omite por completo del DOM).
  • Clases reactivas (Objeto o Array): <div :class="{ 'activo': esActivo, 'text-danger': tieneError }">.

2. Manejo de Eventos: v-on (Atajo @)

Escucha eventos nativos del navegador o eventos personalizados emitidos por componentes hijos. Permite pasar parámetros y utilizar modificadores de eventos encadenables:

  • @click="guardar": Ejecuta el método al hacer clic.
  • @submit.prevent="enviarFormulario": Llama automáticamente a event.preventDefault() sin ensuciar la lógica del método.
  • @click.stop="pararPropagacion": Llama a event.stopPropagation().
  • @keyup.enter="buscar": Escucha la pulsación específica de la tecla Enter.
  • @click.once="accionUnica": El listener se dispara sólo una vez y luego se destruye.

3. Enlace Bidireccional: v-model y Modificadores

v-model es azúcar sintáctico que combina un enlace de valor (:value) y un escucha de eventos (@input o @change), manteniendo en tiempo real el input y la variable de JavaScript sincronizados:

Modificador Sintaxis Utilidad Práctica
.number v-model.number="edad" Convierte automáticamente el string introducido por el usuario a tipo number con parseFloat().
.trim v-model.trim="email" Elimina los espacios en blanco sobrantes al inicio y final de la cadena automáticamente.
.lazy v-model.lazy="texto" Sincroniza el valor al dispararse el evento change (cuando el input pierde el foco), en lugar de cada pulsación (input).

⚡ Panel de Control Interactivo con v-bind, v-model y v-on

Formulario interactivo completo con modificadores de eventos y enlace bidireccional.

index.html
Solo lectura
<!DOCTYPE html>
<html lang="es">
<head>
  <meta charset="utf-8">
  <title>Directivas Principales 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;">
    <h5 class="fw-bold text-success mb-3">Directivas: v-bind, v-model y @eventos</h5>

    <form @submit.prevent="registrarUsuario">
      <div class="mb-3">
        <label class="form-label small text-muted">Nombre de Usuario (.trim):</label>
        <input type="text" v-model.trim="usuario.nombre" class="form-control" placeholder="Escribe tu nombre...">
      </div>

      <div class="mb-3">
        <label class="form-label small text-muted">Presupuesto ($ con .number):</label>
        <input type="number" v-model.number="usuario.presupuesto" class="form-control">
      </div>

      <div class="mb-3 form-check">
        <input type="checkbox" v-model="usuario.aceptaTerminos" id="checkTerminos" class="form-check-input">
        <label for="checkTerminos" class="form-check-label">Acepto los términos de servicio</label>
      </div>

      <!-- v-bind :disabled condicional -->
      <button type="submit" :disabled="!usuario.aceptaTerminos || usuario.nombre.length < 3" class="btn btn-success w-100">
        Enviar Registro
      </button>
    </form>

    <div v-if="mensajeEstado" class="alert alert-primary mt-3 mb-0 py-2">
      {{ mensajeEstado }}
    </div>

    <!-- Vista previa reactiva del estado -->
    <div class="mt-3 p-3 bg-white rounded border">
      <h6 class="fw-bold small text-secondary">Estado Reactivo en Vivo:</h6>
      <pre class="mb-0 text-dark small" style="font-size: 0.78rem;">{{ JSON.stringify(usuario, null, 2) }}</pre>
    </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, reactive, ref } = Vue;

    createApp({
      setup() {
        const usuario = reactive({
          nombre: '',
          presupuesto: 100,
          aceptaTerminos: false
        });

        const mensajeEstado = ref('');

        const registrarUsuario = () => {
          mensajeEstado.value = `¡Registro exitoso para ${usuario.nombre} con $${usuario.presupuesto} de presupuesto!`;
        };

        return {
          usuario,
          mensajeEstado,
          registrarUsuario
        };
      }
    }).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
¿Qué hace internamente el modificador de evento @submit.prevent en Vue.js?
🦉
¿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.