7.7 KiB
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.
- Posición:
- Barra Superior:
- Espaciado izquierdo obligatorio:
pl-14para no solaparse con el botón hamburguesa flotante.
- Espaciado izquierdo obligatorio:
- 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' }).
- Contenedor con
- 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">
- En lugar de modales centrados flotantes, se convierten en Bottom Sheets:
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),AppSidebarpasa 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:
- Columna Izquierda (
AppSidebar): Ancho base colapsadow-[72px], expandible aw-64en hover o al pinchar el botón de anclaje. - 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%);
- Snap scrolling vertical:
- Columna Derecha (
RightSidebar): Anchow-14 lg:w-16, conteniendo el icono de accesibilidad (AccessibilityPanel), el iniciador del chat flotante (FloatingChat) y el logo institucional.
- Columna Izquierda (
- 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-6xlomax-w-7xlcon centrado automáticomx-auto. - Burbujas de chat: limitadas a
max-w-[75%]omax-w-[800px]. - Formularios de administración: disposición en 2 o 3 columnas de campos en lugar de una lista vertical estirada.
- Ancho máximo de tarjetas:
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)
- Tamaño Mínimo de Botón:
min-h-[44px] min-w-[44px]. - Espaciado entre Interactivos: Mínimo
8px(gap-2) para evitar pulsaciones erróneas. - 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.