a2host/.agents/skills/cpic-ui-design-and-templates/references/responsive-screen-layouts.md

7.7 KiB

Arquitectura Responsiva y Layouts Multi-Pantalla - CPIC Conecta

Este documento define la estrategia estructural de interfaz para soportar cualquier dispositivo: smartphones pequeños (320px), tablets, laptops de alta resolución y monitores ultrawide (1440px+).


1. Diagramas de Disposición por Dispositivo

1.1. Vista Móvil (< 768px)

┌────────────────────────────────────────────────────────┐
│ [☰]  [Logo] CPIC Conecta              [💬 Chat]       │ <- Cabecera Compacta (pl-14)
├────────────────────────────────────────────────────────┤
│ [🏠 Inicio] [🎓 Oferta] [🧭 Misión] [📞 Contacto]     │ <- Chips Horizontales (Swipeable)
├────────────────────────────────────────────────────────┤
│                                                        │
│                                                        │
│                  CONTENIDO PRINCIPAL                   │
│               (Scroll Vertical Fluido)                 │
│                                                        │
│                                                        │
│                                                        │
├────────────────────────────────────────────────────────┤
│                                          [♿] [💬]     │ <- Píldora Flotante Inferior
└────────────────────────────────────────────────────────┘

Cuando se pulsa el botón hamburguesa [☰], se despliega un Drawer lateral off-canvas (fixed inset-y-0 left-0 z-50) con telón de fondo oscuro translúcido.


1.2. Vista de Escritorio Estándar (1024px a 1439px)

┌───────┬────────────────────────────────────────┬───────┐
│  APP  │ [🏠 Secciones / Títulos Principales]   │ RIGHT │
│ SIDE  │                                        │ SIDE  │
│  BAR  │  Tarjeta de Sección (Tier 2 Glass)     │  BAR  │
│       │  - Título H1 / H2                      │       │
│ [🏠]  │  - Párrafos de alto contraste          │ [Logo]│
│ [💬]  │  - Botones con acento Lime             │       │
│ [👥]  │                                        │  [♿]  │
│ [📊]  │  ------------------------------------  │       │
│       │                                        │  [💬] │
│       │  (Scroll con Snap Vertical Obligatorio)│   •   │ <- Dots Nav
│       │                                        │   •   │
│ [⚙️]  │                                        │   •   │
│ [🌓]  │                                        │       │
│ [🚪]  │ [ 🏷️ CPIC Conecta • SofiaPlus • SENA ] │       │ <- Footer Retráctil
└───────┴────────────────────────────────────────┴───────┘

2. Especificación Técnica por Rango de Pantalla

2.1. Móvil Pequeño y Estándar (320px - 639px)

  • Contenedor Principal:
    <div className="h-[100dvh] max-h-[100dvh] w-full flex flex-col p-2 gap-2 overflow-hidden relative">
    
  • Botón Hamburguesa Flotante:
    • Posición: fixed top-3 left-3 z-30 md:hidden.
    • Tamaño: w-10 h-10 min-w-[40px] min-h-[40px] rounded-xl bg-white/80 dark:bg-[rgba(10,22,10,0.85)] backdrop-blur-xl border border-black/8 dark:border-white/10.
  • Barra Superior:
    • Espaciado izquierdo obligatorio: pl-14 para no solaparse con el botón hamburguesa flotante.
  • Navegación por Chips:
    • Contenedor con overflow-x-auto flex items-center gap-1.5 py-1 px-1.
    • Ocultar scrollbar estándar: style={{ scrollbarWidth: 'none', msOverflowStyle: 'none' }}.
    • Auto-centrado del chip activo mediante scrollIntoView({ behavior: 'smooth', block: 'nearest', inline: 'center' }).
  • Modales en Móvil:
    • En lugar de modales centrados flotantes, se convierten en Bottom Sheets:
      <div className="fixed inset-x-0 bottom-0 rounded-t-3xl max-h-[90dvh] overflow-y-auto p-5 bg-white/95 dark:bg-[rgba(10,24,10,0.95)] backdrop-blur-3xl border-t border-lime/30 z-50">
      

2.2. Tablet Portrait y Landscape (640px - 1023px)

  • Estructura:
    • sm: activa rejillas de 2 columnas para tarjetas: grid grid-cols-1 sm:grid-cols-2 gap-3.
    • En md: (768px), AppSidebar pasa de ser un drawer móvil oculto a ser una barra lateral fija o colapsada a iconos (w-16).
    • Las tablas deben estar envueltas en contenedores de scroll horizontal con sombra indicadora:
      <div className="w-full overflow-x-auto rounded-2xl border border-black/8 dark:border-white/10">
      

2.3. Escritorio Estándar (1024px - 1439px)

  • Estructura de 3 Columnas:
    1. Columna Izquierda (AppSidebar): Ancho base colapsado w-[72px], expandible a w-64 en hover o al pinchar el botón de anclaje.
    2. Columna Central (main): flex-1 min-w-0 flex flex-col h-full overflow-hidden.
      • Snap scrolling vertical: snap-y snap-mandatory.
      • Máscara de desvanecimiento superior e inferior para evitar cortes bruscos:
        mask-image: linear-gradient(to bottom, transparent 0%, black 1.5%, black 98.5%, transparent 100%);
        -webkit-mask-image: linear-gradient(to bottom, transparent 0%, black 1.5%, black 98.5%, transparent 100%);
        
    3. Columna Derecha (RightSidebar): Ancho w-14 lg:w-16, conteniendo el icono de accesibilidad (AccessibilityPanel), el iniciador del chat flotante (FloatingChat) y el logo institucional.
  • Navegador de Puntos: Columna vertical flotante centrada a la derecha (hidden lg:flex absolute right-4 top-1/2 -translate-y-1/2).

2.4. Pantallas Ultrawide (1440px+ y monitores 4K)

  • En resoluciones ultrawide, evitar que las burbujas de texto o tablas se extiendan de lado a lado sin límite:
    • Ancho máximo de tarjetas: max-w-6xl o max-w-7xl con centrado automático mx-auto.
    • Burbujas de chat: limitadas a max-w-[75%] o max-w-[800px].
    • Formularios de administración: disposición en 2 o 3 columnas de campos en lugar de una lista vertical estirada.

3. Manejo de Viewport y Safe Areas

/* Altura completa del viewport sin salto por barra de navegador móvil */
.app-container {
  height: 100dvh;
  max-height: 100dvh;
  min-height: 100dvh;
}

/* Espaciado para iPhone Notch e Isla Dinámica */
.safe-padding-top {
  padding-top: max(0.75rem, env(safe-area-inset-top));
}

/* Espaciado para barra de inicio (Home indicator) en iOS y Android */
.safe-padding-bottom {
  padding-bottom: max(0.75rem, env(safe-area-inset-bottom));
}

.safe-right {
  right: max(0.75rem, env(safe-area-inset-right));
}

4. Reglas de Accesibilidad Táctil (Mobile Touch Standards)

  1. Tamaño Mínimo de Botón: min-h-[44px] min-w-[44px].
  2. Espaciado entre Interactivos: Mínimo 8px (gap-2) para evitar pulsaciones erróneas.
  3. Gestos y Navegación por Teclado:
    • ArrowDown / PageDown: Desplazar a la siguiente sección activa.
    • ArrowUp / PageUp: Desplazar a la sección anterior.
    • Escape: Cerrar cualquier drawer, modal o menú abierto.