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

151 lines
7.7 KiB
Markdown

# 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**:
```jsx
<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**:
```jsx
<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:
```jsx
<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:
```css
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
```css
/* 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.