Clase 05 · Módulo 05
Listas e imágenes que no se traban
Listas e imágenes que no se traban
Qué logras en esta clase
Muestras cientos de elementos con fotos sin que la pantalla se trabe, y cubres los estados que el usuario realmente ve.
- Eliges entre
ScrollViewyFlatList. - Diseñas los estados de carga, vacío y error.
- Configuras las imágenes para que carguen una vez y se vean bien.
02
Por qué una lista larga se traba
Dibujar un elemento cuesta tiempo y memoria. Si la app dibuja mil filas al abrir la pantalla, el teléfono queda ocupado y deja de responder al dedo, aunque el usuario solo vea ocho.
En teléfonos antiguos o baratos se nota mucho antes que en el tuyo.
03
La idea que lo resuelve
Una lista rápida solo dibuja lo que cabe en la pantalla y un poco más. El resto se crea a medida que te desplazas.
04
ScrollView o FlatList
ScrollView | FlatList | |
|---|---|---|
| Dibuja | Todo de una vez | Solo lo cercano a la vista |
| Sirve para | Contenido fijo y corto | Colecciones de datos |
| Tirar para recargar | Hay que armarlo | Incluido |
| Cargar más al final | Hay que armarlo | Incluido |
Si los elementos vienen de una tabla de la base de datos, casi siempre es FlatList.
05
Las tres props mínimas
<FlatList
data={pedidos}
renderItem={({ item }) => <FilaPedido pedido={item} />}
keyExtractor={(item) => item.id}
/>data es la lista de datos. renderItem dice cómo dibujar uno. keyExtractor entrega un identificador único por elemento.
06
La clave única importa
Con la clave, la lista sabe qué fila es cuál cuando los datos cambian. Si no le das keyExtractor, busca un campo key, luego id, y si no hay ninguno usa la posición.
07
Toda lista tiene cuatro estados
| Estado | Qué ve el usuario |
|---|---|
| Cargando | Una señal de que algo viene |
| Vacía | Por qué no hay nada y qué puede hacer |
| Error | Qué falló y un botón para reintentar |
| Con datos | La lista |
La mayoría de las apps hechas con apuro solo diseña el último. Los otros tres son los que se ven el primer día.
08
Vacío, encabezado y pie
FlatList trae lugares reservados para esto:
ListEmptyComponent: lo que se muestra cuando no hay elementos.ListHeaderComponent: contenido sobre la lista, que se desplaza con ella (un buscador, un resumen).ListFooterComponent: contenido al final (el indicador de «cargando más»).
09
Tirar para recargar
Dos props lo activan: onRefresh, la función que vuelve a pedir los datos, y refreshing, verdadero mientras se espera la respuesta.
El indicador es el propio de cada sistema. Si refreshing nunca vuelve a falso, el indicador se queda girando: revisa que también se apague cuando la petición falla.
10
Cargar más al llegar al final
Traer diez mil registros de una vez es lento. Se pide una página y, cerca del final, la siguiente.
FlatList avisa de ese momento con onEndReached, una prop que hereda de VirtualizedList. Cómo se pide cada página al servidor se ve en los módulos 6 y 7.
11
Cuando la lista no se actualiza
FlatList evita redibujar si sus props no cambiaron. Si una fila depende de algo externo a data (por ejemplo, cuál está seleccionada), la lista no se entera.
Para eso existe extraData: se le pasa ese valor y la lista se redibuja cuando cambia.
12
Primero medir
No optimices una lista que ya va fluida. Pruébala con datos reales en un teléfono modesto y arregla solo si se nota.
13
Ajustes cuando sí hace falta
- Aliviana la fila: menos cajas anidadas, imágenes del tamaño justo.
- Si todas las filas miden lo mismo,
getItemLayoutle ahorra a la lista medirlas. initialNumToRenderdefine cuántas se dibujan al abrir (10 por defecto).- Evita que cada fila se redibuje cuando cambia otra.
Hay listas de la comunidad que reciclan filas, como FlashList, pensadas para colecciones muy grandes. Comprueba su compatibilidad con tu SDK antes de instalarla.
14
Imágenes: el peso que no se ve
Una foto tomada con un teléfono puede medir miles de pixeles por lado. Mostrarla en un cuadro de 80 obliga a descargarla y descomprimirla entera en memoria.
La causa más frecuente de listas lentas no es la lista: son imágenes demasiado grandes. Lo ideal es que el servidor entregue una versión reducida para miniaturas (módulo 9).
15
expo-image: descargar una vez
expo-image guarda las imágenes para no volver a bajarlas. La prop cachePolicy define dónde:
| Valor | Guarda en |
|---|---|
disk (por defecto) | Almacenamiento del teléfono |
memory | Memoria, mientras la app está abierta |
memory-disk | Ambos |
none | No guarda |
Para fotos que no cambian, el valor por defecto ya sirve.
16
Que la espera no se note
placeholder: una versión borrosa y mínima de la imagen, codificada como texto corto (blurhash o thumbhash), que se muestra mientras llega la real.transition: duración en milisegundos del fundido entre la espera y la imagen.
En el SDK 58 la transición acepta skipOnCacheHit, para no animar cuando la imagen ya estaba guardada.
17
Cómo se ajusta al cuadro: contentFit
| Valor | Resultado |
|---|---|
cover (por defecto) | Llena el cuadro; recorta lo que sobra |
contain | Se ve entera; pueden quedar franjas |
fill | Se estira y se deforma |
scale-down | Como contain, sin agrandar |
Para fotos de producto o avatares, cover. Para logos, contain.
18
Detalles para listas con fotos
recyclingKey: en listas que reciclan filas, evita ver por un instante la foto del elemento anterior.priority:low,normalohigh, para que cargue primero lo importante.Image.prefetch: descarga por adelantado imágenes que se van a necesitar.
19
Formatos
Según la referencia de expo-image para el SDK 58, en Android y iOS se admiten WebP, PNG, AVIF, HEIC, JPEG, GIF, SVG e ICO.
WebP y AVIF pesan menos que JPEG a calidad similar. HEIC, el formato de las fotos de iPhone, no se muestra en la versión web: si tu app también corre en navegador, conviértelas al subirlas.
20
Errores comunes
- Dibujar una colección con
mapdentro de unScrollView. - Usar la posición como clave y no diseñar los estados vacío y de error.
- Meter una
FlatListvertical dentro de unScrollViewvertical: pierde su ventaja y el desplazamiento se comporta mal. - Mostrar fotos originales como miniaturas.
- Evaluar la fluidez solo en modo desarrollo y en un teléfono nuevo.
21
Lo que te llevas
- Colecciones de datos en
FlatList, con clave real. - Cuatro estados por lista: cargando, vacía, error y con datos.
- Tirar para recargar y cargar más vienen incluidos.
- En imágenes: tamaño justo, caché, espacio reservado e imagen de espera.
- Se mide antes de optimizar.
22
Hazlo ahora
En 15 minutos:
- Pide a Claude Code una pantalla de lista con 500 elementos de prueba, cada uno con una imagen.
- Desplázate rápido en tu teléfono y observa.
- Vacía los datos y revisa qué se muestra.
- Pide el estado vacío con un mensaje y una acción.
- Agrega tirar para recargar y comprueba que el indicador se apaga.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026