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.

O componente ListView exibe uma lista de rolagem vertical. Você pode definir diferentes v-template para especificar como cada item na lista aparecerá.


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

  <v-template if="$odd">
    <Label :text="item.text" color="red" />
  </v-template>
</ListView>

No exemplo acima, o segundo template será usado se o index do item for ímpar. Por conveniência, você pode usar os helpers $index, $even e $odd, mas conforme necessário, você pode usar qualquer expressão javascript válido para a condição if dos v-template.

Para aprender mais sobre o componente v-template, veja a documentação do v-template.

O ListView não percorre os itens como é esperado usando um loop v-for. Em vez disso, ele só cria as views necessárias para mostrar os itens visíveis na tela, e é normalmente usado em aplicativos móveis para melhorar a performance. Isso é importante porque você não pode confiar nos eventos dentro do v-template, você deve usar o evento itemTap que contém o index do item tocado, assim como o item real da lista.

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

Propriedades

nometipodescrição
forStringExpressão para percorrer o itens, exemplo:
- item in listOfItems
- (item, index) in listOfItems
- item in [1, 2, 3, 4, 5]
itemsArray<any>Um array de itens para mostrar na ListView. Nota: Essa propriedade é apenas para uso avançado, recomendamos que use a propriedade for na maioria dos casos.
separatorColorColorDefine a cor da linha de separação. Defina transparent para removê-la.

Eventos

nomedescrição
itemTapEmitido quando um item do ListView é tocado. Para acessar o item tocado, use event.item.

Componente Nativo

AndroidiOS
android.widget.ListViewUITableView
Contributors