Communitygithub.com

Patrones de UI en React

Patrones modernos de UI en React para estados de carga, manejo de errores y obtención de datos. Útil al construir componentes de interfaz, manejar datos asíncronos o gestionar estados de UI.

¿Qué es Patrones de UI en React?

Este skill proporciona un conjunto completo de patrones modernos para UI en React, enfocados en el manejo correcto de estados de carga, errores, datos vacíos y envío de formularios. Está diseñado para desarrolladores que trabajan con frameworks como React Native, React Web o cualquier interfaz basada en componentes. La documentación detallada incluye principios básicos (como evitar UI obsoleta, mostrar errores siempre, actualizaciones optimistas y divulgación progresiva), árboles de decisión para estados de carga, jerarquías de manejo de errores, patrones para estados vacíos contextuales, y anti-patrones a evitar. Además, se integra con otros skills como graphql-schema, testing-patterns y formik-patterns para ofrecer un flujo de trabajo completo en el desarrollo de UI.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/chriswiles/react-ui-patterns

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Patrones de UI en React?

Principios Básicos

  1. Nunca mostrar UI obsoleto - Indicadores de carga solo cuando realmente se está cargando.
  2. Siempre mostrar errores - Los usuarios deben saber cuando algo falla.
  3. Actualizaciones optimistas - Hacer que la UI se sienta instantánea.
  4. Divulgación progresiva - Mostrar contenido a medida que esté disponible.
  5. 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 CuandoUsar Spinner Cuando
Se conoce la forma del contenidoSe desconoce la forma del contenido
Diseños de listas/tarjetasAcciones de modales
Carga inicial de páginaEnvío de botones
Marcadores de posición de contenidoOperaciones 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

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Skills relacionados