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 aevent.preventDefault()sin ensuciar la lógica del método.@click.stop="pararPropagacion": Llama aevent.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.
<!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>
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿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.