151 lines
7.7 KiB
Markdown
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.
|