Skip to main content

Manual Maestro de Diseño y Programación Web Moderna

Page 1

MANUAL TÉCNICO INTEGRAL · ARQUITECTURA, DISEÑO E INGENIERÍA FRONTEND

Manual Maestro de Diseño y Programación Web Moderna

Guía práctica de extremo a extremo para concebir, diseñar, programar, asegurar y publicar sitios y aplicaciones web profesionales sobre estándares actuales. Construir un producto web sólido exige articular dos disciplinas complementarias: el diseño de interfaces y experiencia de usuario, que organiza la claridad visual y la facilidad de uso, y la ingeniería frontend y arquitectura web, que traduce esa visión en código rápido, accesible y seguro. Este manual reúne los fundamentos esenciales y los patrones de producción utilizados en proyectos modernos. Capítulo

Área Temática

Competencia Clave

Capítulo 01

Arquitectura Web y HTML5 Semántico

Estructura documental, metadatos, formularios nativos y significado del marcado.

Capítulo 02

Maquetación Visual con CSS, Flexbox y Grid

Modelo de caja, cascada moderna, variables de diseño y rejillas bidimensionales.

Capítulo 03

Principios UI/UX, Tipografía y Color

Jerarquía visual, legibilidad en pantalla, sistemas de espaciado y contraste.

Capítulo 04

Diseño Responsivo y Estrategia Mobile-First

Unidades fluidas, tipografía escalable, consultas de contenedor y multimedia adaptable.

Capítulo 05

JavaScript Moderno y Manipulación del DOM

Sintaxis ES contemporánea, delegación de eventos, observadores y estado modular.

Capítulo 06

Consumo de APIs REST y Asincronía

Peticiones HTTP con fetch, manejo de errores, cancelación y caché en memoria.

Capítulo 07

Accesibilidad Web (WCAG) y Diseño Inclusivo

Principios POUR, navegación por teclado, gestión del foco y atributos WAI-ARIA.

Capítulo 08

Rendimiento Web y Core Web Vitals

Optimización de LCP, INP y CLS, ruta crítica de renderizado y compresión de activos.

Capítulo 09

Seguridad Frontend y Protección de Datos

Cifrado HTTPS, cabeceras CSP, prevención de XSS y resguardo de sesiones.

Capítulo 10

Git, Despliegue Continuo, SEO y E-commerce

Control de versiones, indexación técnica, datos estructurados y pasarelas de pago.

Manual Maestro de Diseño y Programación Web Moderna

Page 1 of 10


Capítulo 1. Arquitectura Web y HTML5 Semántico Cada visita a una página web inicia un intercambio estructurado entre el navegador (cliente) y un servidor remoto mediante el protocolo HTTPS. El navegador recibe un archivo HTML inicial, lo analiza secuencialmente y construye en memoria el DOM (Document Object Model), un árbol jerárquico donde cada etiqueta representa un nodo manipulable. Escribir HTML5 semántico consiste en seleccionar cada etiqueta por el significado real de su contenido y no por su apariencia predeterminada. Sustituir contenedores genéricos <div> por elementos descriptivos mejora el posicionamiento en buscadores, facilita el mantenimiento del código y habilita la navegación asistida para lectores de pantalla. <!DOCTYPE html> <html lang="es"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <meta name="description" content="Catálogo técnico de publicaciones sobre desarrollo web."> <title>Editorial Web · Catálogo Profesional</title> </head> <body> <header> <nav aria-label="Navegación principal">...</nav> </header> <main id="contenido-principal"> <article> <h1>Arquitectura de Aplicaciones Web</h1> <p>Contenido autónomo y estructurado del artículo.</p> </article> </main> <footer>...</footer> </body> </html>

Jerarquía de Encabezados y Formularios con Validación Nativa El documento debe contener un único encabezado <h1> que identifique el tema central de la vista, seguido de subtítulos descendentes sin saltar niveles ( <h2> , <h3> ). En formularios, vincular cada control mediante <label for="id"> y aprovechar tipos nativos como type="email" , required y autocomplete mejora la conversión y reduce errores de captura sin código adicional.

Manual Maestro de Diseño y Programación Web Moderna

Page 2 of 10


Multimedia Nativa, Tablas de Datos y Componentes Interactivos Agrupa ilustraciones y capturas técnicas dentro de <figure> acompañadas de su leyenda <figcaption> para asociar contexto descriptivo. Reserva las tablas exclusivamente para datos tabulares estructurados con <thead> , <tbody> y encabezados <th scope="col"> , y aprovecha elementos nativos como <details> y <dialog> antes de programar desplegables o ventanas modales personalizadas.

Capítulo 2. Maquetación Visual con CSS, Flexbox y Grid En CSS, todo elemento se comporta como una caja rectangular formada por contenido, relleno interno ( padding ), borde ( border ) y margen exterior ( margin ). Declarar box-sizing: borderbox; de manera global garantiza que el relleno y el borde se calculen dentro del ancho y alto especificados, evitando desbordamientos imprevistos. Para sistemas de estilos escalables, centraliza la paleta cromática, radios y espaciados en variables personalizadas dentro de :root y organiza las prioridades mediante capas explícitas @layer , evitando selectores excesivamente específicos o el uso de !important . Sistema de Maquetación

Eje de Control

Aplicaciones Óptimas en Producción

Flexbox

Unidimensional (fila o columna)

Barras de navegación, alineación de botones, insignias y controles en línea.

CSS Grid

Bidimensional (filas y columnas)

Estructura general de página, galerías de productos y paneles administrativos.

Subgrid

Hereda pistas de la rejilla padre

Alinear títulos, descripciones y botones entre tarjetas de distinta longitud.

:root { --color-primario: #1e3a8a; --color-acento: #0f766e; --superficie: #ffffff; --borde: #cbd5e1; } .rejilla-catalogo { display: grid; grid-template-columns: repeat(auto-fill, minmax(min(100%, 250px), 1fr)); gap: 1.5rem; }

Manual Maestro de Diseño y Programación Web Moderna

Page 3 of 10


Capas de Cascada, Selectores Modernos y Animación Fluida Organiza las hojas de estilo de proyectos medianos mediante capas explícitas ( @layer reset, base, componentes, utilidades; ) y selectores relacionales como :has() para estilizar contenedores según su estado interno sin añadir clases auxiliares. Para transiciones suaves a 60 fotogramas por segundo, anima exclusivamente propiedades aceleradas por composición gráfica como transform y opacity en lugar de modificar width , height o márgenes.

Capítulo 3. Principios UI/UX, Tipografía y Color El diseño de experiencia de usuario (UX) organiza cómo las personas comprenden y completan tareas, mientras que el diseño de interfaz (UI) traduce esa lógica en señales visuales claras. Una interfaz eficaz aplica la Ley de Proximidad agrupando elementos relacionados mediante espacio en blanco y respeta la Ley de Fitts otorgando a los botones principales áreas táctiles amplias de al menos 44 × 44 píxeles. Dado que más del 85 % de la web es texto, la legibilidad tipográfica define la calidad percibida del sitio. Utiliza un tamaño base de 16px ( 1rem ), un interlineado entre 1.45 y 1.6 para párrafos, y limita el ancho de columna de lectura a un máximo de 65ch (entre 55 y 75 caracteres por línea) para evitar la fatiga ocular. En cuanto al color, aplica la regla de proporción 60-30-10: 60 % de fondos neutros limpios, 30 % de superficies secundarias y tipografía de alto contraste, y 10 % reservado exclusivamente para el color de acento que guía las acciones principales.

Escala Espacial y Estados Completos de Interfaz Adopta una escala de espaciado basada en múltiplos de 8 píxeles (8, 16, 24, 32, 48 y 64 px) para mantener armonía rítmica entre bloques y controles. Asimismo, diseña cada vista contemplando los cinco estados posibles de los datos para evitar pantallas en blanco o mensajes confusos: Estado de Vista

Cuándo Ocurre

Respuesta Visual Recomendada

Estado ideal

Datos cargados y completos

Jerarquía clara con acciones principales visibles y cifrado tabular.

Estado vacío

Primera visita o búsqueda sin coincidencias

Explicación breve junto con una acción directa para crear o limpiar filtros.

Estado de carga

Consulta en curso hacia el servidor

Esqueletos estructurales o indicadores de progreso sin saltos de altura.

Estado de error

Fallo de red o validación rechazada

Mensaje claro en lenguaje humano con botón de reintento inmediato.

Manual Maestro de Diseño y Programación Web Moderna

Page 4 of 10


Capítulo 4. Diseño Responsivo y Estrategia Mobile-First Diseñar bajo el enfoque Mobile-First implica construir primero los estilos base para pantallas estrechas en una sola columna e incorporar progresivamente columnas adicionales mediante consultas @media (min-width: ...) conforme crece el espacio disponible. Este orden prioriza el contenido esencial y evita descargar reglas complejas innecesarias en dispositivos móviles. /* Tipografía fluida sin saltos bruscos entre móvil y escritorio */ h1 { font-size: clamp(1.75rem, 2.8vw + 1rem, 2.65rem); } /* Adaptación modular basada en el tamaño del contenedor padre */ .tarjeta-contenedor { container-type: inline-size; } @container (min-width: 440px) { .tarjeta-producto { display: flex; align-items: center; gap: 1.25rem; } }

Combina unidades relativas ( rem , % , fr y dvh para alturas dinámicas en navegadores móviles) con imágenes adaptables mediante max-width: 100%; height: auto; y el atributo srcset para servir resoluciones ajustadas a cada densidad de pantalla.

Dirección de Arte y Adaptación a Preferencias del Usuario Cuando un diseño requiera recortes distintos según la orientación del dispositivo, emplea la etiqueta <picture> con fuentes condicionadas por media queries y formatos de próxima generación ( type="image/avif" y type="image/webp" ). Complementa la adaptabilidad respetando las preferencias del sistema operativo mediante @media (prefers-reduced-motion: reduce) para desactivar desplazamientos animados y env(safe-area-inset-bottom) para proteger barras fijas inferiores en teléfonos con controles gestuales.

Capítulo 5. JavaScript Moderno y Manipulación del DOM JavaScript moderno prioriza la claridad y la previsibilidad del código mediante declaraciones con alcance de bloque ( const por defecto y let solo cuando se reasigna), desestructuración, encadenamiento opcional ( usuario?.perfil?.nombre ) y métodos funcionales puros sobre arreglos como map() , filter() y reduce() .

Manual Maestro de Diseño y Programación Web Moderna

Page 5 of 10


Para mantener alto rendimiento al interactuar con listas dinámicas, emplea delegación de eventos asignando un único escuchador al contenedor padre y localizando el objetivo exacto con evento.target.closest() . Asimismo, inserta texto proveniente del usuario siempre mediante textContent para evitar la interpretación accidental de etiquetas HTML. const carritoLista = document.querySelector('#lista-carrito'); carritoLista.addEventListener('click', (evento) => { const btnQuitar = evento.target.closest('[data-accion="quitar"]'); if (!btnQuitar) return; const fila = btnQuitar.closest('li'); const idProducto = fila.dataset.id; eliminarDelEstado(idProducto); fila.remove(); });

Para detectar cuándo elementos entran en pantalla sin saturar el hilo principal con eventos scroll , utiliza IntersectionObserver ; y para búsquedas en tiempo real, aplica una función debounce que espere unos 300 milisegundos tras la última pulsación de tecla antes de ejecutar el filtrado.

Persistencia en el Cliente y Desacoplamiento por Eventos Selecciona el mecanismo de almacenamiento adecuado según el ciclo de vida de cada dato: localStorage conserva preferencias visuales entre sesiones (hasta 5 MB), sessionStorage mantiene pasos temporales de un formulario mientras dure la pestaña abierta, e IndexedDB almacena colecciones estructuradas para trabajo sin conexión. Para comunicar módulos independientes sin acoplarlos, emite eventos propios mediante new CustomEvent('carrito:actualizado', { detail }) y recolecta formularios completos con new FormData(formulario) .

Capítulo 6. Consumo de APIs REST y Asincronía Las aplicaciones web intercambian datos con servidores externos mediante APIs REST sobre JSON utilizando los métodos HTTP estándar: GET para consultar recursos, POST para crear registros, PATCH o PUT para actualizarlos y DELETE para eliminarlos. Al utilizar la API nativa fetch() , recuerda que las respuestas HTTP con códigos 404 o 500 no rechazan automáticamente la promesa; es indispensable comprobar respuesta.ok y acoplar un AbortController para cancelar solicitudes lentas o superpuestas.

Manual Maestro de Diseño y Programación Web Moderna

Page 6 of 10


async function consultarAPI(endpoint, opciones = {}) { const controlador = new AbortController(); const limiteTiempo = setTimeout(() => controlador.abort(), 8000);

}

try { const respuesta = await fetch(endpoint, { ...opciones, signal: controlador.signal, headers: { 'Content-Type': 'application/json', ...opciones.headers } }); if (!respuesta.ok) { throw new Error(`Error HTTP ${respuesta.status}`); } return await respuesta.json(); } finally { clearTimeout(limiteTiempo); }

Concurrencia Controlada, Paginación y Caché en Memoria Cuando una pantalla consulta varias fuentes independientes de forma simultánea, utiliza Promise.allSettled() para renderizar los bloques exitosos aunque uno de los servicios secundarios falle. Construye parámetros de filtrado y paginación de forma segura con URLSearchParams , y almacena respuestas frecuentes de catálogos en un objeto Map con tiempo de expiración para ofrecer navegación instantánea.

Capítulo 7. Accesibilidad Web (WCAG) y Diseño Inclusivo La accesibilidad garantiza que cualquier persona —incluyendo usuarios con lectores de pantalla, baja visión o movilidad reducida— pueda navegar y operar el sitio sin barreras. Las pautas internacionales WCAG 2.2 Nivel AA exigen que toda interfaz sea Perceptible, Operable, Comprensible y Robusta. Requisito WCAG

Estándar Técnico

Implementación Práctica

Contraste de texto

Relación ≥ 4.5:1 en cuerpo y ≥ 3:1 en titulares

Verificar combinaciones de texto y fondo antes de publicar.

Operabilidad por teclado

Navegación completa con Tab , Enter y Escape

Estilizar :focus-visible con un anillo de alto contraste visible.

Alternativas textuales

Atributo alt descriptivo en imágenes informativas

Usar alt="" vacío únicamente en gráficos puramente decorativos.

Anuncios dinámicos

Regiones vivas con role="status" o

Comunicar cambios en contadores de carrito o mensajes de confirmación.

aria-live="polite"

Manual Maestro de Diseño y Programación Web Moderna

Page 7 of 10


Formularios Accesibles y Gestión del Foco en Modales Asocia cada campo de entrada con sus instrucciones de ayuda o mensajes de validación mediante aria-describedby y marca los campos erróneos con aria-invalid="true" para que los lectores de pantalla anuncien el motivo exacto del fallo. Al abrir ventanas modales con dialog.showModal() , el navegador atrapa automáticamente el foco dentro del diálogo, permite cerrarlo con la tecla Escape y devuelve el cursor al botón desencadenante al cerrarse.

Capítulo 8. Rendimiento Web y Core Web Vitals La velocidad de carga impacta directamente en la retención de visitantes y en el posicionamiento orgánico. Las métricas Core Web Vitals evalúan tres aspectos críticos de la experiencia real en el navegador: LCP (Largest Contentful Paint ≤ 2.5 s): Tiempo que tarda en pintarse el elemento principal visible. Optimízalo sirviendo imágenes en formatos modernos AVIF o WebP, aplicando fetchpriority="high" a la imagen principal y evitando cargarla de forma diferida. INP (Interaction to Next Paint ≤ 200 ms): Capacidad de respuesta ante clics o pulsaciones. Mantén el hilo principal libre cargando scripts con defer y dividiendo módulos pesados mediante importaciones dinámicas import() . CLS (Cumulative Layout Shift ≤ 0.1): Estabilidad visual. Declara siempre los atributos width y height en todas las imágenes y reserva altura mínima para bloques dinámicos para evitar saltos repentinos del texto.

Optimización Tipográfica, Caché Inmutable y Compresión Entrega las fuentes personalizadas en formato comprimido WOFF2 con subconjuntos de caracteres limitados al idioma del sitio y declara font-display: swap; para evitar texto invisible durante la descarga. En producción, nombra los activos compilados con un identificador hash único y configúralos con Cache-Control: public, max-age=31536000, immutable junto con compresión Brotli en el servidor.

Capítulo 9. Seguridad Frontend y Protección de Datos Todo sitio en producción debe operar exclusivamente sobre HTTPS con redirección automática desde HTTP. En la capa del navegador, la vulnerabilidad más habitual es el Cross-Site Scripting (XSS), que ocurre cuando datos externos sin escapar se ejecutan como código JavaScript. Refuerza la defensa configurando cabeceras HTTP de seguridad en el servidor: Content-SecurityPolicy (CSP) para restringir orígenes autorizados de scripts e imágenes, X-Content-TypeOptions: nosniff para evitar cambios de tipo MIME, y Strict-Transport-Security para forzar conexiones cifradas. Almacena los identificadores de sesión en cookies con atributos HttpOnly , Secure y SameSite=Lax , y nunca expongas llaves privadas de APIs en el código del navegador.

Manual Maestro de Diseño y Programación Web Moderna

Page 8 of 10


Integridad de Subrecursos (SRI) y Validación en Servidor Siempre que cargues una biblioteca externa desde una CDN, incluye el atributo integrity con su resumen criptográfico SHA-384 para impedir la ejecución de archivos alterados en origen. Recuerda además que las validaciones en el navegador solo asisten al usuario: el servidor debe verificar siempre permisos, stock disponible y precios finales antes de registrar cualquier transacción. <script src="https://cdn.ejemplo.org/pasarela-v3.min.js" integrity="sha384oqVuAfXRKap7fdgcCY5uykM6+R9GqQ8K/uxy9rx7HNQlGYl1kPzQho1wx4JwY8wC" crossorigin="anonymous"></script>

Capítulo 10. Git, Despliegue Continuo, SEO y E-commerce El ciclo de desarrollo profesional se apoya en el control de versiones con Git: mantén una rama principal estable ( main ), desarrolla cada mejora en ramas aisladas por funcionalidad y automatiza la publicación mediante flujos de integración y despliegue continuo (CI/CD) conectados a una red de distribución global (CDN).

SEO Técnico y Arquitectura de Comercio Electrónico Para facilitar el rastreo e indexación en motores de búsqueda, define etiquetas <title> y meta description únicas por ruta, establece URLs canónicas ( rel="canonical" ), publica un archivo sitemap.xml actualizado e incorpora datos estructurados en formato JSON-LD. Cuando necesites integrar capacidades de comercio electrónico sobre una web existente, elige la arquitectura acorde a la escala del catálogo: 1. Catálogos ágiles o sitios estáticos: Integra botones de compra embebibles o enlaces de pago hospedados directamente por pasarelas certificadas (como Stripe, Mercado Pago, Culqi o PayPal), delegando el cumplimiento PCI-DSS al proveedor. 2. Tiendas con carrito completo e inventario: Implementa un carrito modular conectado mediante API REST a un backend transaccional que valide precios, stock disponible y cálculo de impuestos en el servidor antes de generar la orden de cobro. 3. Notificación asíncrona (Webhooks): Confirma siempre la acreditación real del pago mediante webhooks firmados en el servidor antes de liberar productos digitales o despachar envíos físicos.

Flujo Práctico de Creación de Sesión de Pago El siguiente patrón muestra cómo iniciar un proceso de cobro seguro desde el navegador enviando únicamente los identificadores y cantidades de productos al servidor, dejando que el backend calcule los importes oficiales y devuelva la URL de pago:

Manual Maestro de Diseño y Programación Web Moderna

Page 9 of 10


async function iniciarCheckout(itemsCarrito) { const respuesta = await fetch('/api/v1/checkout/sesion', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ items: itemsCarrito }) }); if (!respuesta.ok) { throw new Error('No se pudo iniciar la sesión de pago'); } const { urlPago } = await respuesta.json(); window.location.assign(urlPago); }

Lista de verificación antes de lanzar a producción: Confirma que el certificado SSL esté activo, valida todos los formularios en cliente y servidor, verifica el contraste y la navegación por teclado, revisa las métricas Core Web Vitals en red móvil y prueba el flujo completo de compra en modo sandbox antes de habilitar cobros reales.

Manual Maestro de Diseño y Programación Web Moderna

Page 10 of 10


Turn static files into dynamic content formats.

Create a flipbook