---
title: List
description: "A vista `List` presenta información nunha lista vertical de filas. Cada fila contén unha ou máis vistas contidas dentro dunha cela. ```swift List() { Text(\"Levantarme\") Text(\"Ducharme\") Text(\"Almorzar\") Text(\"Coller o bus para ir ao IES San Mamede\") Text(\"Pasar unha gran mañá…"
url: "https://www.drodicio.com/docs/swiftui/tema-3-tipos-de-vistas-en-swiftui/list/"
updated: "2023-12-02"
category: Tema 3. Tipos de vistas en SwiftUI
---

# List

A vista `List` presenta información nunha lista vertical de filas. Cada fila contén unha ou máis vistas contidas dentro dunha cela.

```swift
List() {
            Text("Levantarme")
            Text("Ducharme")
            Text("Almorzar")
            Text("Coller o bus para ir ao IES San Mamede")
            Text("Pasar unha gran mañá aprendendo SwiftUI")
            Text("Coller o bus para casa")
            Text("Xogar á PS5")
        }
```

![](https://www.drodicio.com/wp-content/uploads/2023/10/list_01.png)

## Listas que inclúen múltiples compoñentes

```swift
List() {
            HStack {
                Image(systemName: "trash.circle.fill")
                Text("Tirar o lixo")
            }
            HStack {
                Image(systemName: "person.2.fill")
                Text("Recoller aos nenos no cole")
            }
            HStack {
                Image(systemName: "car.fill")
                Text("Lavar o coche")
            }
        }
```

![](https://www.drodicio.com/wp-content/uploads/2023/10/list_02.png)

## Separadores

É posible modificar a liña que separa cada elemento dunha lista:

- `.listRowSeparator(.hidden)`: Oculta a liña
- `.listRowSeparatorTint(cor)`: Colorea a liña
- `.listRowBackground(Image(imaxe))`: Pon unha imaxe de fondo nun elemento nunha lista

```swift
List() {
            Text("Levantarme")
                .listRowSeparator(.hidden)
            Text("Ducharme")
            Text("Almorzar")
                .listRowSeparatorTint(.blue)
            Text("Coller o bus para ir ao IES San Mamede")
            Text("Xogar á PS5")
                .listRowBackground(Image("ps5").scaleEffect(0.07))
            Text("Cear")
            Text("Repasar PMDM")
                .listRowSeparatorTint(.yellow)
            Text("Deitarse")
        }
```

![](https://www.drodicio.com/wp-content/uploads/2023/10/list_03.png)

## Listas dinámicas

Unha lista considérase dinámica cando contén un conxunto de elementos que poden cambiar co tempo: Os elementos pódense engadir, editar e eliminar e a lista actualízase dinámicamente para reflectir eses cambios.

### `Identificable` (protocolo)

Para admitir unha lista deste tipo, cada elemento de datos que se mostrará debe estar contido dentro dunha clase ou estrutura que se axuste ao protocolo `Identificable`.

- O protocolo `Identificable` require que a instancia conteña unha propiedade chamada id
- A propiedade chamada `id` se pode utilizar para identificar de forma única cada elemento da lista.
- A propiedade `id` pode ser de calquera tipo que se axuste ao protocolo `Hashable`, que inclúe os tipos `String`, `Int` ou `UUID`.
- Se usamos o tipo `UUID` na propiedade `id`, o método `UUID()` pódese utilizar para xerar automaticamente un ID único para cada elemento da lista.

Así, o seguinte código implementa unha estrutura simple para un exemplo de lista de tarefas pendentes que se axusta ao protocolo Identificable.

**Neste caso, o ID xérase automaticamente a través dunha chamada a UUID():**

```swift
struct ListaTarefas: Identifiable {
    var id = UUID()
    var tarefa: String
    var nomeImaxe: String
}
```

### Empregar listas dinámicas

Para empregar unha `List` dinámica, temos que ter un array de elementos que siguen o protocolo `Identificable`, tal e como expliquei no anterior apartado. Unha vez que temos o array:

- Definimos unha `List` dos elementos do array (liña 24 da imaxe inferior)
- Recorremos o array mediante a sentencia nome_variable in (no exemplo da imaxen, o nome_variable é `item` . Vemos este paso na liña 25 da imaxe inferior
- Por cada elemento nome_variable do array, debuxamos as vistas que desexemos e accedemos aos datos do elemento `nome_variable`. Das liña 27 a 30, creamos un `HStack` co nome da tarefa e da imaxe.

Agora a lista xa non necesita unha vista para cada celda. No seu lugar, a lista itera a través do array de datos e reutiliza a mesma declaración `HStack`, simplemente conectando os datos apropiados para cada elemento do array.

![](https://www.drodicio.com/wp-content/uploads/2023/10/list_04.png)

```swift
import SwiftUI

struct ListaTarefas: Identifiable {
    var id = UUID()
    var tarefa: String
    var nomeImaxe: String
}

struct ContentView: View {
    @State var lista: [ListaTarefas] = [
    ListaTarefas(tarefa: "Tirar o lixo", nomeImaxe: "trash.circle.fill"),
    ListaTarefas(tarefa: "Recoller aos nenos", nomeImaxe: "person.2.fill"),
    ListaTarefas(tarefa: "Lavar o coche", nomeImaxe: "car.fill")
    ]

    var body: some View {
        List(lista){
            item in

            HStack {
                Image(systemName: item.nomeImaxe)
                Text(item.tarefa)
            }
        }
    }
}
```

## ForEach - Contido estático e dinámico ao mesmo tempo

En situacións nas que o contido dinámico e estático debe mostrarse xuntos dentro dunha lista, a instrución `ForEach` pódese usar dentro do corpo da lista para iterar a través dos datos dinámicos á vez que se declaran entradas estáticas.

O seguinte exemplo inclúe un botón `Toggle` estático xunto cun bucle `ForEach` para o contido dinámico:

![](https://www.drodicio.com/wp-content/uploads/2023/10/list_05.png)

```swift
import SwiftUI

struct ListaTarefas: Identifiable {
    var id = UUID()
    var tarefa: String
    var nomeImaxe: String
}

struct ContentView: View {
    @State var lista: [ListaTarefas] = [
    ListaTarefas(tarefa: "Tirar o lixo", nomeImaxe: "trash.circle.fill"),
    ListaTarefas(tarefa: "Recoller aos nenos", nomeImaxe: "person.2.fill"),
    ListaTarefas(tarefa: "Lavar o coche", nomeImaxe: "car.fill")
    ]

    @State private var estadoBoton = true

    var body: some View {
        List {
            Toggle(isOn: $estadoBoton) {
                Text("Permitir notificacións")
            }

            ForEach(lista) { tarefa in
                HStack {
                    Image(systemName: tarefa.nomeImaxe)
                    Text(tarefa.tarefa)
                }
            }
        }
    }
}
```

## Seccións

Unha `List` pódese dividir en seccións, incluíndo encabezamentos (headers) e pés (footers):

![](https://www.drodicio.com/wp-content/uploads/2023/10/list_06.png)

```swift
import SwiftUI

struct ListaTarefas: Identifiable {
    var id = UUID()
    var tarefa: String
    var nomeImaxe: String
}

struct ContentView: View {
    @State var lista: [ListaTarefas] = [
    ListaTarefas(tarefa: "Tirar o lixo", nomeImaxe: "trash.circle.fill"),
    ListaTarefas(tarefa: "Recoller aos nenos", nomeImaxe: "person.2.fill"),
    ListaTarefas(tarefa: "Lavar o coche", nomeImaxe: "car.fill")
    ]

    @State private var estadoBoton = true

    var body: some View {
        List {
            Section(header: Text("Axustes")){
                Toggle(isOn: $estadoBoton) {
                    Text("Permitir notificacións")
                }
            }

            Section(header: Text("Tarefas"), footer: Text("Non te esquezas de nada 🧐")){
                ForEach(lista) { tarefa in
                    HStack {
                        Image(systemName: tarefa.nomeImaxe)
                        Text(tarefa.tarefa)
                    }
                }
            }
        }
    }
}
```

## Listas refrescables

Os datos que se amosan nunha pantalla a miúdo cambian co tempo.

- O paradigma estándar dentro das aplicacións iOS é que o usuario realice un refresco cara abaixo para actualizar os datos mostrados.
- Durante o proceso de actualización, a aplicación normalmente mostrará un indicador de progreso xiratorio despois do cal se amosan os datos máis recentes.

Para facilitar isto, SwiftUl proporciona o modificador `refreshable()`. Cando se aplica a unha vista, un xesto de refresco cara abaixo nesa vista mostrará o indicador de progreso e executará o código no peche do modificador.

Por exemplo:

![](https://www.drodicio.com/wp-content/uploads/2023/10/list_09.png)

```swift
import SwiftUI

struct ListaTarefas: Identifiable {
    var id = UUID()
    var tarefa: String
    var nomeImaxe: String
}

struct ContentView: View {
    @State var lista: [ListaTarefas] = [
    ListaTarefas(tarefa: "Tirar o lixo", nomeImaxe: "trash.circle.fill"),
    ListaTarefas(tarefa: "Recoller aos nenos", nomeImaxe: "person.2.fill"),
    ListaTarefas(tarefa: "Lavar o coche", nomeImaxe: "car.fill")
    ]

    @State private var estadoBoton = true

    var body: some View {
        List {
            Section(header: Text("Axustes")){
                Toggle(isOn: $estadoBoton) {
                    Text("Permitir notificacións")
                }
            }

            Section(header: Text("Tarefas"), footer: Text("Non te esquezas de nada 🧐")){
                ForEach(lista) { tarefa in
                    HStack {
                        Image(systemName: tarefa.nomeImaxe)
                        Text(tarefa.tarefa)
                    }
                }
            }
        }
        .refreshable {
            lista += [
                ListaTarefas(tarefa: "Encargar a cea", nomeImaxe: "eurosign.circle.fill"),
                ListaTarefas(tarefa: "Chamar a miña colega Lola Mento", nomeImaxe: "phone.fill"),
            ]
        }
    }
}
```
