You are reading docs for v1.3.1, click here for the latest version.
ListView

This is an overview of the most common usage of ListView. For more information about the available properties, methods, or events, head over to the complete API documentation for ListView.

<ListView> es un componente de UI que muestra elementos en una lista verticalmente desplazable. Para estableceer como la lista muestra cada uno de los elementos puedes usar el componente <v-template>.

<ListView for="item in listOfItems" @itemTap="onItemTap">
  <v-template>
    <!-- Shows the list item label in the default color and style. -->
    <Label :text="item.text" />
  </v-template>
</ListView>

Usando <ListView> con multiples bloques <v-template>

El componente <v-template> es utilizado para definir como se va a mostrar cada elemento de la lista dentro de la pantalla.

Si necesitas visualizar uno o más elementos de manera diferente al resto, puedes ingresarlos como hijos de un componente <v-template> y utilizar las condiciones que sean necesarias. Dentro de un <ListView>, puedes usar todos los <v-template> que creas necesarios.

<ListView for="item in listOfItems" @itemTap="onItemTap">
  <v-template>
    <Label :text="item.text" />
  </v-template>

  <v-template if="$odd">
    <!-- For items with an odd index, shows the label in red. -->
    <Label :text="item.text" color="red" />
  </v-template>
</ListView>

Cuando creas condiciones para un <v-template>, puedes usar cualquier expresión de JavaScript válida o también cualquiera de estos helpers:

  • $index— el índice del elemento actual
  • $eventrue indica si el índice del elemento actual es par
  • $oddtrue indica si el índice del elemento actual es impar

Una nota importante sobre v-for

<ListView> no puede iterar los elementos de la forma en que lo hace la directiva v-for. En su lugar, el componente solo crea las vistas necesarias para mostrar los elementos que estan actualmente visibles dentro de la pantalla (y reutiliza las vistas que estan fuera de la pantalla a medida que el usuario se va desplazando). Este concepto se denomina view recycling y es un patrón muy común usado en aplicaciones móviles con el propósito de mejorar el rendimiento de las mismas.

Esto es muy importante ya que **no puedes confiar en eventos que estan enlazados a v-template. En lugar de eso, debes usar el evento itemTap. Este evento recibe como argumentos, el índice del elemento presionado y el elemento actual de la lista.

onItemTap(event) {
  console.log(event.index)
  console.log(event.item)
}

NOTA: Si un v-for es usado dentro de un <ListView>, una advertencia será mostrada en la consola y se convertira automáticamente en una propiedad for.

Propiedades

NombreTipoDescripción
forStringProvee una expresión para iterar por todos los elementos.
Por ejemplo:
  • item in listOfItems
  • (item, index) in listOfItems
  • item in [1, 2, 3, 4, 5]
itemsArray<any>Una colección de elementos para mostrar dentro del <ListView>.
Esta propiedad es solo para uso avanzado. En su lugar use la propiedad for.
separatorColorColorEstablece la línea que separa cada elemento. Puedes usar el valor transparent para eliminarla.

Eventos

NombreDescripción
itemTapEmitido cuando un elemento perteneciente al <ListView> es presionado. Para acceder al elemento presionado, podes usar event.item.

Métodos

NombreDescripción
refresh()(Disponible pronto) Fuerza al componente <ListView> a recargar todos los elementos.

Componente nativo

AndroidiOS
android.widget.ListViewUITableView
Contributors