VueJS

Directiva v-for en Vue JS

Resumen

En este post te mostraré cómo repetir cosas en la vista de una app con Vue.JS usando v-for.

v-for permite iterar arreglos, objetos y también hacer ciclos.

Veremos cómo usar v-for, además de proporcionar la clave con :key y finalmente tomar el índice y el valor por separado.

Nota: a través de los ejemplos usaré Bootstrap 4 para un mejor diseño, aunque esto no va a interferir con el tema principal de v-for y Vue.

Sintaxis de v-for

La sintaxis de v-for en Vue.js es:

v-for="elemento in coleccion"

Si se quiere obtener el índice se puede con:

v-for="(elemento, indice) in coleccion"

Y en caso de repetir cierta cantidad de veces:

v-for="numero in 5" (bueno, en este caso se repetiría 5 veces)

Ejemplo 1 – Directiva v-for con arreglo

La directiva se coloca dentro de una etiqueta HTML que se quiere repetir. Vamos a ver un ejemplo sencillo con una lista:

<!DOCTYPE html>
<html>

<head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width">
 <title>Uso de v-for en Vue.js</title>
 <link href="https://stackpath.bootstrapcdn.com/bootstrap/4.3.1/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-ggOyR0iXCbMQv3Xipma34MD+dH/1fQ784/j6cY/iJTQUOhcWr7x9JvoRxT2MZw1T"
  crossorigin="anonymous">

</head>

<body>

 <main role="main" class="container">
  <div class="row">
   <div class="col-12" id="app">
    <h1>Uso de v-for en Vue.js</h1>
    <a href="//parzibyte.me/blog">By Parzibyte</a>
    <ul>
     <li v-for="mascota in mascotas">{{mascota}}</li>
    </ul>
   </div>
  </div>
 </main>
 <script src="https://cdn.jsdelivr.net/npm/vue@2.6.10/dist/vue.js">

 </script>
 <script src="script.js">

 </script>
</body>

</html>

Comenzamos declarando nuestro contenedor de app en la línea 17.

En la línea 21 tenemos a v-for, que va a repetir la variable (disponible solo en la vista) llamada mascota en los elementos que haya en mascotas.

Dentro de la lista (elemento li) accedemos a la variable y la mostramos.

El JavaScript para esto es el siguiente:

new Vue({
 el: "#app",
 data: () => ({
  mascotas: ["Maggie", "Panqué", "Guayaba", "Meca"],
 })
});

Simplemente declaramos el arreglo mascotas en data.

Nota: si el arreglo está vacío, no se genera ningún error.

Recorrer arreglo con Vue.JS usando v-for

Ejemplo 2 – repetir sobre objeto usando Vue.JS

Además de un arreglo, también se pueden repetir los valores de un objeto o diccionario de JavaScript.

Por ejemplo. Tenemos la siguiente definición:

new Vue({
 el: "#app",
 data: () => ({
  calificaciones: {
   "Luis": 10,
   "Fernando": 5,
   "Rodrigo": 7,
  },
 })
});

En la línea 4 estamos declarando un objeto que tiene nombres de alumnos como clave, y la calificación de cada uno como valor.

En el HTML hacemos lo siguiente:

<!DOCTYPE html>
<html>

<head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width">
 <title>Uso de v-for en Vue.js</title>
 <link href="https://stackpath.bootstrapcdn.com/bootstrap/4.3.1/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-ggOyR0iXCbMQv3Xipma34MD+dH/1fQ784/j6cY/iJTQUOhcWr7x9JvoRxT2MZw1T"
  crossorigin="anonymous">

</head>

<body>

 <main role="main" class="container">
  <div class="row">
   <div class="col-12" id="app">
    <h1>Uso de v-for en Vue.js</h1>
    <a href="//parzibyte.me/blog">By Parzibyte</a>
    <ul>
     <li v-for="calificacion in calificaciones">{{calificacion}}</li>
    </ul>
   </div>
  </div>
 </main>
 <script src="https://cdn.jsdelivr.net/npm/vue@2.6.10/dist/vue.js">

 </script>
 <script src="script.js">

 </script>
</body>

</html>

Es la misma sintaxis. Si ahora ejecutamos la app veremos que se renderiza una lista con calificaciones.

Si quisiéramos mostrar el nombre, es decir, la clave, tendríamos que recorrer con dos variables como veremos a continuación.

Ejemplo 3: repetir sobre objeto con clave y valor

Para obtener la clave y el valor del objeto al usar v-for simplemente hay que declarar ambas variables. Cambiando el v-for así:

<ul>
  <li v-for="(calificacion, nombre) in calificaciones">{{nombre}} => {{calificacion}}</li>
</ul>

Lo que daría la siguiente salida en donde se imprime tanto la clave como el valor:

Sintaxis de clave, valor en Vue.js

Ejemplo 4 con Vue – Recorrer arreglo con índice y valor

Lo mismo que aplicamos al recorrer el diccionario podemos aplicarlo cuando recorremos un arreglo.

En este caso tomaríamos el índice numérico y el valor del arreglo.

Nota: vamos a ver cómo recorrer un arreglo de objetos, así vemos también cómo es posible acceder al objeto dentro del v-for.

Veamos el siguiente ejemplo. Comenzamos por el script:

new Vue({
 el: "#app",
 data: () => ({
  canciones: [
   {
    nombre: "Can I play with madness",
    artista: "Iron Maiden"
   },
   {
    nombre: "Stranger in town",
    artista: "Toto"
   },
   {
    nombre: "Shattered",
    artista: "The Rolling Stones"
   },
   {
    nombre: "Space Oddity",
    artista: "David Bowie"
   },
   {
    nombre: "Peppermint Twist",
    artista: "Sweet"
   },
  ],
 })
});

Tenemos un arreglo normal, que tiene objetos en su interior con las propiedades nombre y artista.

Para recorrerlo hacemos esto:

<!DOCTYPE html>
<html>

<head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width">
 <title>Uso de v-for en Vue.js</title>
 <link href="https://stackpath.bootstrapcdn.com/bootstrap/4.3.1/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-ggOyR0iXCbMQv3Xipma34MD+dH/1fQ784/j6cY/iJTQUOhcWr7x9JvoRxT2MZw1T"
  crossorigin="anonymous">

</head>

<body>

 <main role="main" class="container">
  <div class="row">
   <div class="col-12" id="app">
    <h1>Uso de v-for en Vue.js</h1>
    <a href="//parzibyte.me/blog">By Parzibyte</a>
    <ul>
     <li v-for="(cancion, indice) in canciones">
      <strong>Índice {{indice}}</strong> |
      {{cancion.artista}} - {{cancion.nombre}}
     </li>
    </ul>
   </div>
  </div>
 </main>
 <script src="https://cdn.jsdelivr.net/npm/vue@2.6.10/dist/vue.js">

 </script>
 <script src="script.js">

 </script>
</body>

</html>

Ahora tenemos el índice, y el objeto de la canción.

Repetir contenido de arreglo de objetos con Vue.js

Para dibujarla simplemente accedemos a cada propiedad a través del punto.

Ejemplo 5 – Dibujar tabla con v-for

Lo anterior también puede ser dibujado dentro de una tabla, pues v-for se encarga de repetir los elementos sin importar el tipo.

Veamos el ejemplo. Lo único que cambia es la vista, pues los datos se quedan intactos.

La vista queda así:

<!DOCTYPE html>
<html>

<head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width">
 <title>Uso de v-for en Vue.js</title>
 <link href="https://stackpath.bootstrapcdn.com/bootstrap/4.3.1/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-ggOyR0iXCbMQv3Xipma34MD+dH/1fQ784/j6cY/iJTQUOhcWr7x9JvoRxT2MZw1T"
  crossorigin="anonymous">

</head>

<body>

 <main role="main" class="container">
  <div class="row">
   <div class="col-12" id="app">
    <h1>Uso de v-for en Vue.js</h1>
    <a href="//parzibyte.me/blog">By Parzibyte</a>
    <table class="table">
     <thead>
      <tr>
       <th>Índice</th>
       <th>Canción</th>
       <th>Artista</th>
      </tr>
     </thead>
     <tbody>
      <tr v-for="(cancion, indice) in canciones">
       <td>{{indice}}</td>
       <td>{{cancion.nombre}}</td>
       <td>{{cancion.artista}}</td>
      </tr>
     </tbody>
    </table>
   </div>
  </div>
 </main>
 <script src="https://cdn.jsdelivr.net/npm/vue@2.6.10/dist/vue.js">

 </script>
 <script src="script.js">

 </script>
</body>

</html>

Lo único que hacemos es repetir el tr (la fila de la tabla) en la línea 29.

El resultado es el siguiente:

Renderizar tabla con Vue usando directiva v-for

Ejemplo 6: la clave o key

En algunas ocasiones, y sobre todo cuando queremos que los cambios se reflejen si modificamos el arreglo u objeto, es necesario proporcionar al elemento una clave.

Esta clave debe ser única, y debe ser un tipo de dato primitivo.

En el caso de las canciones la clave podría ser el índice, pues no se repite. La misma es especificada con :key

<!DOCTYPE html>
<html>

<head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width">
 <title>Uso de v-for en Vue.js</title>
 <link href="https://stackpath.bootstrapcdn.com/bootstrap/4.3.1/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-ggOyR0iXCbMQv3Xipma34MD+dH/1fQ784/j6cY/iJTQUOhcWr7x9JvoRxT2MZw1T"
  crossorigin="anonymous">

</head>

<body>

 <main role="main" class="container">
  <div class="row">
   <div class="col-12" id="app">
    <h1>Uso de v-for en Vue.js</h1>
    <a href="//parzibyte.me/blog">By Parzibyte</a>
    <table class="table">
     <thead>
      <tr>
       <th>Índice</th>
       <th>Canción</th>
       <th>Artista</th>
      </tr>
     </thead>
     <tbody>
      <tr :key="indice" v-for="(cancion, indice) in canciones">
       <td>{{indice}}</td>
       <td>{{cancion.nombre}}</td>
       <td>{{cancion.artista}}</td>
      </tr>
     </tbody>
    </table>
   </div>
  </div>
 </main>
 <script src="https://cdn.jsdelivr.net/npm/vue@2.6.10/dist/vue.js">

 </script>
 <script src="script.js">

 </script>
</body>

</html>

Lo único que cambia está en la línea 29, pues especificamos el atributo key.

A nivel de vista esto no cambia nada, pero cuando se desean vigilar y actualizar los cambios de un objeto esto es necesario. Además, siempre es una buena práctica especificar una clave.

Ejemplo 7: un simple ciclo

Para terminar, veamos cómo repetir un elemento determinadas veces, algo como un simple ciclo for.

Si queremos repetir algo determinadas veces, especificamos un número en lugar de un arreglo u objeto.

Por ejemplo:

v-for="numero in 5"

Modifiquemos la vista para que ahora sea así:

<!DOCTYPE html>
<html>

<head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width">
 <title>Uso de v-for en Vue.js</title>
 <link href="https://stackpath.bootstrapcdn.com/bootstrap/4.3.1/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-ggOyR0iXCbMQv3Xipma34MD+dH/1fQ784/j6cY/iJTQUOhcWr7x9JvoRxT2MZw1T"
  crossorigin="anonymous">

</head>

<body>

 <main role="main" class="container">
  <div class="row">
   <div class="col-12" id="app">
    <h1>Uso de v-for en Vue.js</h1>
    <a href="//parzibyte.me/blog">By Parzibyte</a>
    <table class="table">
     <thead>
      <tr>
       <th>Índice</th>
       <th>Número</th>
      </tr>
     </thead>
     <tbody>
      <tr :key="indice" v-for="(numero, indice) in 5">
       <td>{{indice}}</td>
       <td>{{numero}}</td>
      </tr>
     </tbody>
    </table>
   </div>
  </div>
 </main>
 <script src="https://cdn.jsdelivr.net/npm/vue@2.6.10/dist/vue.js">

 </script>
 <script src="script.js">

 </script>
</body>

</html>

Presta atención a la línea 28. Lo que hacemos es contar del 1 al 5, usando un índice.

El script queda así (solo se define la app y su elemento, pero no hay datos, porque el ciclo se hace en la vista):

new Vue({
 el: "#app",
});

Estoy aquí para ayudarte 🤝💻


Estoy aquí para ayudarte en todo lo que necesites. Si requieres alguna modificación en lo presentado en este post, deseas asistencia con tu tarea, proyecto o precisas desarrollar un software a medida, no dudes en contactarme. Estoy comprometido a brindarte el apoyo necesario para que logres tus objetivos. Mi correo es parzibyte(arroba)gmail.com, estoy como@parzibyte en Telegram o en mi página de contacto

No te pierdas ninguno de mis posts 🚀🔔

Suscríbete a mi canal de Telegram para recibir una notificación cuando escriba un nuevo tutorial de programación.
parzibyte

Programador freelancer listo para trabajar contigo. Aplicaciones web, móviles y de escritorio. PHP, Java, Go, Python, JavaScript, Kotlin y más :) https://parzibyte.me/blog/software-creado-por-parzibyte/

Entradas recientes

Creador de credenciales web – Aplicación gratuita

Hoy te voy a presentar un creador de credenciales que acabo de programar y que…

1 semana hace

Desplegar PWA creada con Vue 3, Vite y SQLite3 en Apache

Ya te enseñé cómo convertir una aplicación web de Vue 3 en una PWA. Al…

2 semanas hace

Arquitectura para wasm con Go, Vue 3, Pinia y Vite

En este artículo voy a documentar la arquitectura que yo utilizo al trabajar con WebAssembly…

2 semanas hace

Vue 3 y Vite: crear PWA (Progressive Web App)

En un artículo anterior te enseñé a crear un PWA. Al final, cualquier aplicación que…

2 semanas hace

Errores de Comlink y algunas soluciones

Al usar Comlink para trabajar con los workers usando JavaScript me han aparecido algunos errores…

2 semanas hace

Esperar promesa para inicializar Store de Pinia con Vue 3

En este artículo te voy a enseñar cómo usar un "top level await" esperando a…

2 semanas hace

Esta web usa cookies.