4. Renderizado Condicional (v-if vs v-show) y Listas Eficientes con v-for y key
Conoce las diferencias cruciales de rendimiento entre montar/desmontar nodos (v-if) y alternar display CSS (v-show), y renderiza colecciones reactivas blindadas con el atributo :key.
Estructuras de Control en Plantillas: Condicionales y Bucles
Para construir interfaces dinámicas, Vue proporciona directivas declarativas para mostrar u ocultar elementos en función de condiciones booleanas (v-if y v-show) e iterar sobre colecciones de datos (v-for). Entender el costo computacional de cada una y el papel de la propiedad :key es clave para evitar bugs de estado y cuellos de botella.
1. Renderizado Condicional: v-if vs v-show
| Característica | v-if / v-else-if / v-else | v-show |
|---|---|---|
| Mecanismo DOM | Inserta o destruye físicamente el nodo del DOM real y sus listeners. | El elemento siempre está en el DOM; sólo conmuta display: none en CSS. |
| Costo de Render Inicial | Bajo: si la condición inicial es falsa, el elemento ni siquiera se crea. | Alto: compila y monta el elemento en el DOM independientemente del valor inicial. |
| Costo de Alternancia (Toggle) | Alto: requiere crear, montar o destruir componentes hijos y listeners. | Muy bajo: solo cambia una regla CSS de visualización en el navegador. |
| Regla de Oro | Úsalo cuando la condición rara vez cambie en la sesión (ej: permisos de admin). | Úsalo si necesitas alternar la visibilidad frecuentemente (ej: pestañas, acordeones, modales). |
2. Listas Reactivas con v-for y la Importancia de :key
La directiva v-for itera sobre arrays, objetos o rangos numéricos con la sintaxis (elemento, index) in coleccion:
<li v-for="tarea in listaTareas" :key="tarea.id">
{{ tarea.titulo }}
</li>
¿Por qué :key es obligatoria y nunca debe ser el índice del array?
El algoritmo de parche de Virtual DOM de Vue utiliza key como un identificador único para saber con exactitud qué elemento fue añadido, movido o eliminado. Si usas el índice numérico (:key="index"), al borrar o reordenar un elemento, Vue reutilizará erróneamente los inputs y estados internos de los componentes hijos, produciendo bugs sutiles en formularios.
3. Buena Práctica Oficial: NUNCA mezcles v-if con v-for en el mismo elemento
En Vue 3, cuando v-if y v-for existen en el mismo nodo, v-if tiene mayor prioridad de evaluación y no tendrá acceso a las variables definidas dentro del alcance de v-for. La solución idiomática es filtrar la lista previamente con una propiedad computed o envolver la lista con una etiqueta <template v-for="...">.
⚡ Gestor de Tareas Interactivo con v-for, :key y Filtro Condicional
Colección reactiva con adición, marcado de completado y alternancia visual eficiente.
<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="utf-8">
<title>Listas y Condicionales en Vue 3</title>
<link href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css" rel="stylesheet">
<style>
.completada { text-decoration: line-through; opacity: 0.6; }
</style>
</head>
<body class="p-4 bg-light">
<div id="app" class="card shadow-sm p-4 mx-auto" style="max-width: 500px;">
<h5 class="fw-bold text-success mb-3">Lista de Metas Diarias</h5>
<!-- Formulario para agregar -->
<div class="input-group mb-3">
<input type="text" v-model.trim="nuevaTarea" @keyup.enter="agregarTarea" placeholder="Nueva meta..." class="form-control">
<button @click="agregarTarea" :disabled="!nuevaTarea" class="btn btn-success">+ Añadir</button>
</div>
<!-- Toggle de visibilidad con v-show -->
<div class="form-check form-switch mb-3">
<input class="form-check-input" type="checkbox" v-model="mostrarSoloPendientes" id="switchFiltro">
<label class="form-check-label small" for="switchFiltro">Ocultar tareas completadas</label>
</div>
<!-- Lista reactiva con v-for y :key -->
<ul v-if="tareasFiltradas.length > 0" class="list-group mb-3">
<li v-for="tarea in tareasFiltradas" :key="tarea.id" class="list-group-item d-flex justify-content-between align-items-center">
<div class="form-check">
<input type="checkbox" v-model="tarea.completada" :id="'t-' + tarea.id" class="form-check-input">
<label :for="'t-' + tarea.id" :class="{ 'completada': tarea.completada }" class="form-check-label">
{{ tarea.titulo }}
</label>
</div>
<button @click="eliminarTarea(tarea.id)" class="btn btn-sm btn-outline-danger py-0 px-2">×</button>
</li>
</ul>
<!-- Mensaje cuando la lista está vacía con v-else -->
<div v-else class="alert alert-secondary text-center py-3 mb-0">
🎉 ¡No tienes tareas pendientes que mostrar!
</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, computed } = Vue;
createApp({
setup() {
const nuevaTarea = ref('');
const mostrarSoloPendientes = ref(false);
const tareas = ref([
{ id: 1, titulo: 'Aprender sintaxis de Vue 3', completada: true },
{ id: 2, titulo: 'Configurar Composition API', completada: false },
{ id: 3, titulo: 'Construir tienda con Pinia', completada: false }
]);
const agregarTarea = () => {
if (!nuevaTarea.value) return;
tareas.value.push({
id: Date.now(),
titulo: nuevaTarea.value,
completada: false
});
nuevaTarea.value = '';
};
const eliminarTarea = (id) => {
tareas.value = tareas.value.filter(t => t.id !== id);
};
const tareasFiltradas = computed(() => {
if (mostrarSoloPendientes.value) {
return tareas.value.filter(t => !t.completada);
}
return tareas.value;
});
return {
nuevaTarea,
mostrarSoloPendientes,
tareasFiltradas,
agregarTarea,
eliminarTarea
};
}
}).mount('#app');
</script>
</body>
</html>
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Por qué se debe utilizar una clave única y estable (:key="item.id") al renderizar listas con v-for?
¿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.