¿Qué hace Patrones de UI en React?
Principios Básicos
- Nunca mostrar UI obsoleto - Indicadores de carga solo cuando realmente se está cargando.
- Siempre mostrar errores - Los usuarios deben saber cuando algo falla.
- Actualizaciones optimistas - Hacer que la UI se sienta instantánea.
- Divulgación progresiva - Mostrar contenido a medida que esté disponible.
- Degradación gradual - Datos parciales son mejores que ningún dato.
Patrones de Estado de Carga
La Regla de Oro
Mostrar indicador de carga SOLO cuando no hay datos para mostrar.
// CORRECTO - Solo mostrar carga cuando no hay datos
const { data, loading, error } = useGetItemsQuery();
if (error) return <ErrorState error={error} onRetry={refetch} />;
if (loading && !data) return <LoadingState />;
if (!data?.items.length) return <EmptyState />;
return <ItemList items={data.items} />;
// INCORRECTO - Muestra spinner incluso cuando tenemos datos en caché
if (loading) return <LoadingState />; // ¡Parpadea al recargar!
Árbol de Decisión para Estado de Carga
¿Hay un error?
→ Sí: Mostrar estado de error con opción de reintentar
→ No: Continuar
¿Está cargando Y no tenemos datos?
→ Sí: Mostrar indicador de carga (spinner/esqueleto)
→ No: Continuar
¿Tenemos datos?
→ Sí, con elementos: Mostrar los datos
→ Sí, pero vacío: Mostrar estado vacío
→ No: Mostrar carga (fallback)
Esqueleto vs Spinner
| Usar Esqueleto Cuando | Usar Spinner Cuando |
|---|---|
| Se conoce la forma del contenido | Se desconoce la forma del contenido |
| Diseños de listas/tarjetas | Acciones de modales |
| Carga inicial de página | Envío de botones |
| Marcadores de posición de contenido | Operaciones en línea |
Patrones de Manejo de Errores
Jerarquía de Manejo de Errores
1. Error en línea (a nivel de campo) → Errores de validación de formulario
2. Notificación toast → Errores recuperables, el usuario puede reintentar
3. Banner de error → Errores a nivel de página, datos aún parcialmente utilizables
4. Pantalla de error completa → No recuperable, necesita acción del usuario
Mostrar Errores Siempre
CRÍTICO: Nunca tragar errores en silencio.
// CORRECTO - Error siempre visible para el usuario
const [createItem, { loading }] = useCreateItemMutation({
onCompleted: () => {
toast.success({ title: 'Elemento creado' });
},
onError: (error) => {
console.error('createItem falló:', error);
toast.error({ title: 'Error al crear elemento' });
},
});
// INCORRECTO - Error atrapado en silencio, el usuario no se entera
const [createItem] = useCreateItemMutation({
onError: (error) => {
console.error(error); // ¡El usuario no ve nada!
},
});
Patrón de Componente de Estado de Error
interface ErrorStateProps {
error: Error;
onRetry?: () => void;
title?: string;
}
const ErrorState = ({ error, onRetry, title }: ErrorStateProps) => (
<div className="error-state">
<Icon name="exclamation-circle" />
<h3>{title ?? 'Algo salió mal'}</h3>
<p>{error.message}</p>
{onRetry && (
<Button onClick={onRetry}>Intentar de nuevo</Button>
)}
</div>
);
Patrones de Estado de Botón
Estado de Carga del Botón
<Button
onClick={handleSubmit}
isLoading={isSubmitting}
disabled={!isValid || isSubmitting}
>
Enviar
</Button>
Deshabilitar Durante Operaciones
CRÍTICO: Siempre deshabilitar los disparadores durante operaciones asíncronas.
// CORRECTO - Botón deshabilitado mientras carga
<Button
disabled={isSubmitting}
isLoading={isSubmitting}
onClick={handleSubmit}
>
Enviar
</Button>
// INCORRECTO - El usuario puede tocar varias veces
<Button onClick={handleSubmit}>
{isSubmitting ? 'Enviando...' : 'Enviar'}
</Button>
Estados Vacíos
Requisitos para Estado Vacío
Toda lista/colección DEBE tener un estado vacío:
// INCORRECTO - Sin estado vacío
return <FlatList data={items} />;
// CORRECTO - Estado vacío explícito
return (
<FlatList
data={items}
ListEmptyComponent={<EmptyState />}
/>
);
Estados Vacíos Contextuales
// Búsqueda sin resultados
<EmptyState
icon="search"
title="Sin resultados"
description="Prueba con otros términos de búsqueda"
/>
// Lista sin elementos aún
<EmptyState
icon="plus-circle"
title="Sin elementos aún"
description="Crea tu primer elemento"
action={{ label: 'Crear Elemento', onClick: handleCreate }}
/>
Patrón de Envío de Formulario
const MyForm = () => {
const [submit, { loading }] = useSubmitMutation({
onCompleted: handleSuccess,
onError: handleError,
});
const handleSubmit = async () => {
if (!isValid) {
toast.error({ title: 'Por favor corrige los errores' });
return;
}
await submit({ variables: { input: values } });
};
return (
<form>
<Input
value={values.name}
onChange={handleChange('name')}
error={touched.name ? errors.name : undefined}
/>
<Button
type="submit"
onClick={handleSubmit}
disabled={!isValid || loading}
isLoading={loading}
>
Enviar
</Button>
</form>
);
};
Anti-Patrones
Estados de Carga
// INCORRECTO - Spinner cuando hay datos (causa parpadeo)
if (loading) return <Spinner />;
// CORRECTO - Solo mostrar carga sin datos
if (loading && !data) return <Spinner />;
Manejo de Errores
// INCORRECTO - Error tragado
async function mutation() {
try {
await mutation();
} catch (e) {
console.log(e); // ¡El usuario no se entera!
}
}
// CORRECTO - Error visible
onError: (error) => {
console.error('operación falló:', error);
toast.error({ title: 'Operación falló' });
}
Estados de Botón
// INCORRECTO - Botón no deshabilitado durante el envío
<Button onClick={submit}>Enviar</Button>
// CORRECTO - Deshabilitado y muestra carga
<Button onClick={submit} disabled={loading} isLoading={loading}>
Enviar
</Button>
Lista de Verificación
Antes de completar cualquier componente de UI:
Estados de UI:
- Estado de error manejado y mostrado al usuario
- Estado de carga mostrado solo cuando no hay datos
- Estado vacío proporcionado para colecciones
- Botones deshabilitados durante operaciones asíncronas
- Botones muestran indicador de carga cuando corresponda
Datos y Mutaciones:
- Las mutaciones tienen manejador onError
- Todas las acciones del usuario tienen retroalimentación (toast/visual)
Integración con Otros Skills
- graphql-schema: Usar patrones de mutación con manejo adecuado de errores
- testing-patterns: Probar todos los estados de UI (carga, error, vacío, éxito)
- formik-patterns: Aplicar patrones de envío de formularios