HTML de cero a experto

El esqueleto de toda la web: semántica que los buscadores premian, formularios listos para hablar con PHP — incluida la subida de archivos —, multimedia nativa y accesibilidad real hasta construir una página completa lista para producción.

32 capítulos Bootstrap 5.3 Modo claro / oscuro Optimizado para móvil HTML Living Standard · WHATWG
32
Capítulos
150+
Ejemplos de código
3
Niveles: básico a experto
0
Requisitos previos
Cómo usar este tutorial: sigue los capítulos en orden (el índice está en el menú si lees desde el móvil). Cada capítulo tiene teoría, ejemplos ejecutables y puntos clave al final. Practica cada ejemplo: es la única vía para dominar cualquier tema.

1 · Qué es HTML5 y cómo piensa el navegador

Básico ~10 min

Antes de escribir una sola etiqueta: qué es realmente un documento HTML y qué hace el navegador con él.

HTML no es un lenguaje de programación: es un lenguaje de marcado. No ejecuta lógica — describe estructura y significado. Cada etiqueta le dice al navegador «esto es un párrafo», «esto es un enlace», «esto es lo más importante de la página». CSS lo pinta, JavaScript le da comportamiento; sin tu markup, no hay nada que pintar ni controlar.

Estándar vivo, versión 5 enterrada

El nombre «HTML5» quedó como marca de época. Desde el 2019 quien define el lenguaje es el WHATWG con un HTML Living Standard: ya no hay «HTML6» que esperar — los navegadores incorporan mejoras continuamente. Lo que verás en este manual (dialog, popover, loading lazy) funciona hoy en todos los navegadores modernos.

Anatomía de una etiqueta

<p class="intro">Hola, mundo</p>
└┬┘ └────┬─────┘ └───┬───┘    └┬┘
 etiqueta  atributo   contenido  cierre
  • Etiqueta de apertura: <p>; cierre: </p>.
  • Atributos: pares nombre="valor" que configuran el elemento.
  • Void elements: algunos no tienen cierre — <img>, <br>, <input>.

Del texto al árbol: el DOM

Cuando el navegador recibe tu archivo, lo parsea y construye un árbol de objetos llamado DOM (Document Object Model). Ahí viven los errores típicos del principiante:

<ul>
  <li>Café</li>
  <li>Té
</ul>                    <!-- error: falta cerrar el segundo li -->

El navegador no avisa: adivina tu intención, cierra el <li> por ti y sigue. HTML es perdonador — demasiado. Por eso existe el validador oficial del W3C (Nu Html Checker): pegas tu código o tu URL y encuentra lo que el navegador calla. Úsalo desde tu primera página. Y por eso un elemento mal anidado puede romper estilos sin que veas nada raro en el código fuente: el DOM real no siempre es tu HTML.

Idea clave del manual: escribe HTML pensando en el SIGNIFICADO (semántica), no en el aspecto visual. El aspecto se lo delegamos a CSS; el significado es lo que le sirve a Google, a un lector de pantalla y a tu yo futuro.

Las tres capas de una página web

CapaTecnologíaResponsabilidad
Estructura + significadoHTMLqué ES cada cosa
PresentaciónCSScómo SE VE
ComportamientoJavaScriptqué HACE

Este manual te da la primera capa sólida. La segunda y la tercera llegan en los manuales de CSS y JavaScript, que siguen a este en la ruta; más adelante, en la serie PHP, estos mismos formularios hablarán con una API real.

Practica

BásicoEste párrafo cierra las etiquetas en el orden equivocado: <p><strong>Oferta: <em>café</strong> de Chanchamayo</em></p>. Corrígelo para que cada etiqueta se cierre antes que la que la contiene.

Ver solución 1
<p><strong>Oferta: <em>café</em></strong> <em>de Chanchamayo</em></p>

Las etiquetas se cierran en orden inverso al que se abrieron, como cajas una dentro de otra. Si dos cajas se «cruzan», el navegador adivina la estructura y el DOM ya no es lo que escribiste.

RetoEscribiste <p>Precio: <div>S/ 25</div></p>. Abre el inspector: ¿qué árbol construye el navegador? Luego reescríbelo para que el precio quede DENTRO del párrafo.

Ver solución 2
<!-- DOM real que construye el navegador:
     <p>Precio: </p>
     <div>S/ 25</div>
     <p></p>                 ← el </p> sobrante crea un párrafo vacío -->

<p>Precio: <span class="precio">S/ 25</span></p>

Un <div> no puede vivir dentro de <p>: el navegador cierra el párrafo antes del div. Para marcar un trozo dentro de una línea de texto se usa <span>.

Puntos clave

  • HTML describe significado; no programa comportamiento ni pinta.
  • Living Standard WHATWG: sin versiones que esperar.
  • El navegador corrige tus errores en silencio al construir el DOM.
  • Semántica primero: la vista es trabajo de CSS.

2 · Tu primera página

Básico ~10 min

El esqueleto mínimo obligatorio y cómo servirlo sin instalar nada.

<!DOCTYPE html>
<html lang="es">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Mi primera página</title>
</head>
<body>
  <h1>Funciona</h1>
  <p>Esta es mi primera página HTML.</p>
</body>
</html>

Línea por línea

PiezaPara qué existe
<!DOCTYPE html>Activa el modo estándar. Sin él, el navegador imita bugs de 1998 (quirks mode) y tu CSS enloquece.
lang="es"Idioma del contenido: lectores de pantalla pronuncian bien; Google segmenta mejor.
<head>Metadatos: NO se ven, describen la página (charset, viewport, título).
charset="utf-8"Primer hijo del head SIEMPRE: permite ñ, tildes, emoji. Sin esto: «Ã±» por todas partes.
viewportHace que el móvil use su ancho real. Sin esto, Bootstrap y el responsive no existen.
<title>Texto de la pestaña y PRIMER factor SEO on-page (cap. 24).
<body>Todo lo visible.
Orden sagrado en el head: charset antes que title, viewport antes que cualquier estilo. Es la única «ceremonia» obligatoria de HTML.

El mapa del documento: qué vive en cada zona

Tres preguntas que todo principiante se hace — ¿dónde va el CSS?, ¿dónde va el JS?, ¿por qué ahí? — y que conviene resolver desde hoy. El mapa completo:

<html lang="es">
 ├─ head   →  zona INVISIBLE: metadatos de la página
 │    ├─ meta charset / viewport
 │    ├─ title
 │    ├─ link rel="stylesheet"   ← el CSS vive aquí
 │    └─ script defer            ← el JS moderno también
 └─ body   →  zona VISIBLE: el contenido
      ├─ header / nav / main / footer
      ├─ textos, imágenes, tablas, formularios…
      └─ script al final         ← la escuela clásica
  • El CSS en el head: los estilos deben estar listos ANTES del primer render; si llegan tarde, la página aparece un instante sin estilo (el famoso FOUC) y luego «salta».
  • El JS al final del body — escuela clásica: un script sin defer DETIENE el parseo justo donde aparece; colocarlos últimos dejaba ver primero todo el contenido.
  • La escuela moderna: <script src="..." defer> en el head descarga en paralelo y ejecuta cuando el DOM está listo — mismo efecto que el truco clásico, pero mejor. Es la regla de la casa; se demuestra a fondo en el capítulo 26.
  • Ambas escuelas coinciden en lo esencial: el JS NUNCA bloquea tu contenido visible ni deja la página muerta mientras carga.
Regla práctica para todo el manual: CSS siempre en el head; JS con defer (o al final del body si es un script inline corto, como el registro del service worker del capítulo 30).

Ejemplo completo aplicando el mapa

La misma idea de la primera página, ahora con las tres zonas del mapa ocupadas como corresponde. Tres archivos, un solo resultado:

<!DOCTYPE html>
<html lang="es">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Mi tienda</title>

  <!-- ZONA INVISIBLE: estilos y comportamiento -->
  <link rel="stylesheet" href="estilos.css">
  <script src="app.js" defer></script>
</head>
<body>
  <!-- ZONA VISIBLE: el contenido -->
  <header>
    <h1>Mi tienda</h1>
  </header>
  <main>
    <p id="mensaje">Bienvenido. Hay una oferta esperándote.</p>
    <button id="btn-oferta" type="button">Ver oferta</button>
  </main>
  <footer>
    <small>&copy; 2026 Mi tienda</small>
  </footer>
</body>
</html>
/* estilos.css — vive en el head via link */
header {
  background: #0d9488;
  color: #fff;
  padding: 1rem;
}
// app.js — declarado con defer en el head
document.getElementById("btn-oferta").addEventListener("click", () => {
  document.getElementById("mensaje").textContent =
    "¡Hoy: 20% de descuento en cafés!";
});
  • estilos.css entra por <link> en el head: los estilos están listos ANTES del primer render.
  • app.js se declara ARRIBA pero ejecuta ABAJO: gracias a defer, cuando corre, el botón ya existe aunque esté «más abajo».
  • El body solo contiene contenido semántico: header/main/footer del mapa.
  • Abre DevTools → Network y verás CSS y JS descargando EN PARALELO, ninguno tapando al otro.

Variante clásica equivalente: si app.js NO llevara defer, habría que moverlo al final del body para no bloquear el render:

  <footer>
    <small>&copy; 2026 Mi tienda</small>
  </footer>

  <!-- escuela clasica: ultimo hijo del body -->
  <script src="app.js"></script>
</body>
</html>

Servir la página

Un doble clic al archivo funciona para practicar (file://), pero limita: algunas APIs exigen http. Usa un servidor estático — el mismo hábito que mantendrás en el manual de JavaScript:

$ cd mi-proyecto
$ npx serve .
# → http://localhost:3000

Código fuente vs. DOM: no son lo mismo

  1. Clic derecho → Ver código fuente: muestra TU archivo, intacto.
  2. F12 → Elements/Inspector: muestra el DOM tras las correcciones del parser.

Escribe un <table> sin <tbody> y mira Elements: ahí aparece uno inventado. El inspector enseña el HTML REAL; el código fuente, el que tú escribiste. Depurar es comparar ambos.

Indentación y mayúsculas: la convención de la casa

  • Minúsculas en etiquetas y atributos: <img src="...">, nunca <IMG SRC=...>.
  • Atributos SIEMPRE entre comillas dobles.
  • Un nivel de indentación por profundidad: el DOM se lee como árbol.
  • Cierre opcional omitido = bug mañana. Cierra TODO, incluso donde no es obligatorio.

Practica

BásicoEscribe desde cero el documento mínimo de la tienda «Aroma y Punto» con los cuatro imprescindibles (DOCTYPE, lang, charset y viewport), un title y un h1 visible.

Ver solución 1
<!DOCTYPE html>
<html lang="es">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Aroma y Punto · Café de origen peruano</title>
</head>
<body>
  <h1>Aroma y Punto</h1>
</body>
</html>

charset va primero dentro del head para que el navegador lea bien las tildes desde la primera línea.

RetoAmplía el documento anterior: agrega una meta description, enlaza css/estilos.css y carga js/app.js sin bloquear el dibujo de la página. Ubica cada pieza en la zona correcta del mapa.

Ver solución 2
<!DOCTYPE html>
<html lang="es">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Aroma y Punto · Café de origen peruano</title>
  <meta name="description" content="Cafés de especialidad de Chanchamayo y Cusco, tostados cada semana.">
  <link rel="stylesheet" href="css/estilos.css">
  <script src="js/app.js" defer></script>
</head>
<body>
  <h1>Aroma y Punto</h1>
</body>
</html>

Todo lo que el usuario no ve (metadatos, estilos, scripts) vive en el head. Con defer el script se descarga en paralelo y se ejecuta cuando el HTML ya está listo.

Puntos clave

  • DOCTYPE + lang + charset + viewport = los 4 imprescindibles.
  • npx serve desde el día uno: mismo entorno que producción.
  • Fuente ≠ DOM: el inspector manda al depurar.
  • Convenciones uniformes ahora evitan diffs basura después.

3 · Texto: encabezados y párrafos

Básico ~12 min

El 80% de una página es texto bien marcado. La jerarquía de encabezados es donde se gana o se pierde el SEO.

h1–h6: una escalera, no un catálogo de tamaños

<article>
  <h1>Café de origen peruano</h1>         <!-- UNO solo por vista -->
    <h2>Variedades</h2>
      <h3>Typica</h3>
      <h3>Bourbon</h3>
    <h2>Preparación</h2>
      <h3>V60</h3>
</article>
  • Un solo <h1> por página: el tema central (Google lo usa).
  • Nunca saltes niveles (h2 → h4) ni los elijas por tamaño: el tamaño se cambia con CSS.
  • La jerarquía forma el índice semántico que usan lectores de pantalla (navegación por tecla H) y el featured snippet de Google.

Énfasis con significado

<p><strong>Atención:</strong> el pedido vence <em>mañana</em>.</p>

<p><b>Nota:</b> negrita SIN importancia (estilo).</p>
<p><i>Coffea arabiga</i> — nombre científico, sin énfasis.</p>
EtiquetaSemánticaÚsalo para…
<strong>importancia fuerteavisos, advertencias
<em>énfasis de vozcambiar el sentido de la frase
<b>solo visualpalabras clave, nombres de UI
<i>solo visualtérminos técnicos, idiomas extranjeros
<small>letra pequeña legaldisclaimers, letra chica
<mark>resaltado contextualcoincidencias de búsqueda
<abbr title="">abreviaturaIGV, SUNAT con tooltip explicativo
<time datetime="2026-08-23">fecha legible por máquinasfechas y horas en contenido

Entidades: los caracteres especiales

<p>Panadería &amp; Cafetería &lt;El Trigal&gt; — 5&nbsp;kg</p>
Escribe…Se ve…Cuándo
&lt; / &gt;< / >mostrar etiquetas como texto
&amp;&ampersand literal
&quot;"comillas dentro de atributos
&nbsp;espacio duroS/ 150.00 sin salto de línea
&copy;©pies de página (o el carácter directo)

Saltos y separaciones honestas

<p>Jr. Unión 123,<br>Cusco</p>       <!-- br SOLO para dirección/poesía -->
<hr>                                  <!-- cambio de TEMA, no una linea decorativa -->
Anti-patrón: apilar <br><br> para «dar espacio». El espacio es CSS (margin), no HTML. Y <p> ya trae su separación propia.

Practica

BásicoMarca la «Guía del café» con una jerarquía sin saltos: título principal, dos secciones («Variedades» y «Preparación») y, dentro de Variedades, los subtemas «Arábica» y «Robusta», cada uno con un párrafo.

Ver solución 1
<h1>Guía del café</h1>

<h2>Variedades</h2>
<h3>Arábica</h3>
<p>Dulce y aromática; la más cultivada en los valles del Perú.</p>
<h3>Robusta</h3>
<p>Más amarga y con el doble de cafeína.</p>

<h2>Preparación</h2>
<p>Molienda media, agua a 92 °C y cuatro minutos de reposo.</p>

Un solo h1 y ningún salto de nivel (de h2 no se pasa a h4). El tamaño visual se decide en CSS, no eligiendo otro encabezado.

RetoMuestra en pantalla, literalmente, este texto: Usa <strong> para importancia & <em> para énfasis. Debajo, escribe la dirección «Jr. Unión 120 / Lima» en dos líneas sin crear dos párrafos.

Ver solución 2
<p>Usa &lt;strong&gt; para importancia &amp; &lt;em&gt; para énfasis.</p>

<p>Jr. Unión 120<br>
Lima</p>

Los caracteres <, > y & que son CONTENIDO se escriben como entidades. <br> es legítimo en direcciones y poemas, donde el salto de línea es parte del contenido.

Puntos clave

  • Un h1, sin saltos de nivel: la jerarquía es SEO + accesibilidad.
  • strong/em significan; b/i solo estilizan.
  • <, > y & SIEMPRE como entidades cuando son contenido.
  • br para direcciones/poemas; hr para cambios de tema; nada más.

4 · Enlaces: el superpoder de la web

Básico ~12 min

La etiqueta que convierte documentos sueltos en una web: dominar href es dominar la mitad del HTML práctico.

Las cuatro formas de href

<a href="paginas/contacto.html">relativo a la carpeta actual</a>
<a href="/api/productos">desde la raiz del sitio</a>
<a href="https://developer.mozilla.org">absoluto: otro sitio</a>
<a href="#precios">ancla interna: baja a esa seccion</a>
  • Relativo sin /: hermano o hijo de la página actual — ideal para maquetas locales.
  • /raíz: sobrevive reorganizaciones; así linken los sitios reales y las SPAs.
  • Ancla: cualquier elemento con ese id recibe el salto. Con CSS scroll-behavior: smooth, queda navegación de una página gratis.

target="_blank" nunca viene solo

<a href="https://banco.ejemplo.pe" target="_blank"
   rel="noopener noreferrer">Ver estado de cuenta</a>

Sin rel="noopener", la pestaña nueva puede manipular TU página vía window.opener (phishing de tab). Los navegadores modernos lo aplican solos, pero explícito = auditoría limpia.

Esquemas útiles más allá de http

<a href="mailto:percy@3soft.pe?subject=Cotizacion">Escríbenos</a>
<a href="tel:+51987654321">Llámanos</a>
<a href="/catalogo-2026.pdf" download>Descargar catálogo</a>
  • tel: en móvil abre el teclado: oro para negocios locales.
  • download fuerza descarga aunque sea un PDF visible en navegador.

Texto del enlace: la regla del contexto fuera de línea

MALBIENPor qué
clic aquíVer precios de envíosLos lectores de pantalla listan enlaces SIN contexto
más infoRequisitos del RUC nuevo«Más» ¿de qué? Google también lee ese texto
URL cruda largaNormativa SUNAT 2026Inpronunciable e inútil para SEO

Prueba rápida: lee tu página imaginando solo la lista de enlaces. Si no entiendes a dónde va cada uno, reescríbelos.

Enlaces que parecen botones (y viceversa)

<a class="btn btn-primary" href="/registro">Crear cuenta</a>  <!-- NAVEGA -->
<button type="button" onclick="guardar()">Guardar borrador</button> <!-- ACTUA -->
  • <a> = cambio de ubicación (con href siempre).
  • <button> = acción en la página (submit, JS).
  • Un div con onclick NO es clicable para teclado ni lectores: nunca lo uses como enlace.
Puente al curso PHP: los href con query string (productos.php?cat=cafe&pag=2) alimentan $_GET. En el capítulo 12 formalizaremos GET vs POST; por ahora nota cómo el enlace YA pasa parámetros sin formulario.

Practica

BásicoCrea un menú con las cuatro formas de href: relativo (contacto.html), desde la raíz (/catalogo/), absoluto a https://www.gob.pe en otra pestaña y un ancla a la sección «Horarios» de la misma página.

Ver solución 1
<p>
  <a href="contacto.html">Contacto</a> ·
  <a href="/catalogo/">Catálogo</a> ·
  <a href="https://www.gob.pe" target="_blank" rel="noopener noreferrer">Portal del Estado peruano</a> ·
  <a href="#horarios">Horarios</a>
</p>

<section id="horarios">
  <h2>Horarios</h2>
  <p>Lunes a sábado, de 8:00 a 20:00.</p>
</section>

target="_blank" siempre va con rel="noopener noreferrer": la página nueva no podrá controlar la tuya.

RetoAgrega un enlace que inicie una llamada al +51 987 654 321 y otro que abra el correo a ventas@aromaypunto.pe con el asunto «Pedido mayorista». Además, mejora este enlace: Para ver precios haz clic <a href="precios.html">aquí</a>.

Ver solución 2
<p><a href="tel:+51987654321">Llámanos: +51 987 654 321</a></p>
<p><a href="mailto:ventas@aromaypunto.pe?subject=Pedido%20mayorista">Escríbenos a ventas@aromaypunto.pe</a></p>

<p>Consulta la <a href="precios.html">lista de precios por kilo</a>.</p>

Los espacios del asunto se codifican como %20. «Aquí» no dice nada fuera de contexto: un lector de pantalla que lista los enlaces de la página solo oiría «aquí, aquí, aquí».

Puntos clave

  • 4 formas de href: relativo, raíz, absoluto, ancla.
  • _blank exige rel="noopener noreferrer".
  • Texto de enlace descriptivo: SEO y lectores de pantalla.
  • a navega, button actúa — jamás div-clicable.

5 · Imágenes básicas

Básico ~12 min

El elemento que más rompe layouts y más penaliza el rendimiento si se usa sin cuidado.

La receta obligatoria

<img src="img/taza-v60.webp"
     alt="Taza de ceramica con cafe pasado en filtro V60"
     width="800" height="600">
AtributoPara quéSi falta…
srcruta de la imagennada se ve (obvio)
alttexto alternativo OBLIGATORIOlector de pantalla anuncia la ruta cruda; si la imagen falla, caja vacía
width + heightproporciones reservadas ANTES de cargarsaltos de layout: CLS rojo en Lighthouse (cap. 26)

Los atributos width/height NO fijan el tamaño visual — solo informan la PROPORCIÓN. El tamaño final lo decide tu CSS (max-width: 100%; height: auto;). Con ambos, el navegador reserva el espacio exacto.

alt que sirve de verdad

  • Imagen informativa: describe lo que aporta — «Molinillo manual con café molido fino» no «foto1.png» ni «imagen de un molinillo» (redundante: ya sabe que es imagen).
  • Imagen decorativa: alt="" (vacío, pero PRESENTE) — el lector de pantalla la salta. Sin atributo ≠ vacío: sin atributo es error.
  • Imagen-enlace: el alt describe el DESTINO — «Ir al carrito».
  • Captura de texto (gráfico, factura): transcribe lo esencial.

Formatos: cuál y por qué

FormatoFuerzaÚsalo para…
AVIFmáxima compresión modernafotos cuando puedas servirlo (con fallback)
WebP30% menor que JPEG, universal hoydefault de fotos e ilustraciones
JPEG/PNGcompatibilidad totalfallbacks y casos muy específicos (PNG: transparencia dura)
SVGvector, escala infinitologos, iconos (cap. 21)

La elección fina entre formatos con fallback automático es trabajo de <picture> — capítulo 20.

figure: imagen CON pie formal

<figure>
  <img src="img/curva-tueste.webp" alt="Curva de tueste: temperatura vs tiempo"
       width="640" height="360" loading="lazy">
  <figcaption>Fig. 1 — Perfil de tueste medio usado en el taller.</figcaption>
</figure>
  • loading="lazy" nativo: descarga solo cuando va a entrar al viewport. NUNCA en la imagen principal (hero) — atrasaría el LCP.
  • figcaption queda asociado semánticamente a su imagen aunque los separes con CSS.
  • Adelanto: imágenes responsivas completas (srcset/picture) en cap. 20.
Puente al curso JS: el CLS que evitas con width/height es una de las tres Core Web Vitals del cap. 39 de js_01. HTML bien escrito ya suma puntos ahí.

Practica

BásicoInserta la foto img/chanchamayo.webp (800 × 600 px) de un saco de café recién tostado, con texto alternativo útil, dimensiones reservadas y carga diferida.

Ver solución 1
<img src="img/chanchamayo.webp"
     alt="Saco de yute abierto con granos de café de Chanchamayo recién tostados"
     width="800" height="600" loading="lazy">

width y height reservan el espacio antes de que llegue la imagen: la página no «salta» al cargar.

RetoPresenta el diagrama img/tueste.svg (640 × 360) como figura con pie formal «Curva de tueste medio, en minutos», y agrega un separador decorativo img/hoja.svg (120 × 24) que un lector de pantalla debe ignorar.

Ver solución 2
<figure>
  <img src="img/tueste.svg" alt="Gráfico: la temperatura sube de 180 a 210 °C entre los minutos 2 y 11"
       width="640" height="360">
  <figcaption>Curva de tueste medio, en minutos.</figcaption>
</figure>

<img src="img/hoja.svg" alt="" width="120" height="24">

Una imagen decorativa lleva alt="" PRESENTE y vacío: si omites el atributo, el lector de pantalla leerá el nombre del archivo.

Puntos clave

  • src + alt SIEMPRE + width/height para reservar espacio.
  • Decorativa = alt="" presente; informativa = descripción útil.
  • WebP/AVIF como default, SVG para vectores.
  • lazy para todo MENOS la imagen principal.

6 · HTML semántico: adiós a la divitis

Intermedio ~13 min

Las etiquetas que le dan un MAPA a tu página — para Google, para lectores de pantalla y para ti dentro de seis meses.

El diagnóstico: divitis

<div class="top">
  <div class="menu">...</div>
</div>
<div class="contenido">
  <div class="post">...</div>
</div>
<div class="pie">...</div>

<!-- funciona, pero no SIGNIFICA nada: un mar de cajas iguales -->

La cura: landmarks estructurales

<header>                <!-- intro de la pagina o de una seccion -->
  <nav aria-label="Principal">...</nav>
</header>

<main>                  <!-- UNO solo por pagina: el contenido unico -->
  <article>             <!-- pieza autocontenida: post, producto, noticia -->
    <header><h1>...</h1></header>
    <p>...</p>
    <section>           <!-- agrupacion tematica CON encabezado propio -->
      <h2>Comentarios</h2>
      ...
    </section>
  </article>

  <aside>               <!-- tangencial: relacionados, publicidad, filtros -->
    ...
  </aside>
</main>

<footer>                <!-- cierre: contacto, legal, sitemap -->
  ...
</footer>

article vs section vs div: la decisión

EtiquetaPrueba mental
<article>¿Tendría sentido en un RSS o compartida sola? Sí → article
<section>¿Agrupa contenido por tema Y tiene su h2/h3? Sí → section
<aside>¿Se puede quitar sin que el contenido principal pierda sentido? Sí → aside
<div>Solo para layout/estilo cuando NINGUNA semántica aplica — no es pecado, es último recurso

nav y header/footer: pueden repetirse

  • Varios <nav> son válidos (principal, breadcrumbs, paginación): distínguelos con aria-label.
  • Cada <article> puede tener su header/footer propios (autor y fecha del post, no del sitio).
  • <main> es único y NO vive dentro de article/aside/nav/header/footer.

Quién consume tu semántica

ConsumidorQué aprovecha
Googlemain vs aside: qué es contenido central; nav para sitelinks
Lectores de pantallalandmarks = navegación rápida por secciones (tecla D en NVDA)
Modo lector (Safari/Firefox)article + jerarquía limpia = lectura sin ruido
Tu equipoclass="div2-copia" no necesita documentación si el tag ya explica
Puente al curso JS: la SPA que construirás en el cap. 41 de js_01 inyectará vistas en <main>. Esa frontera existe GRACIAS a esta semántica: el router sabrá exactamente dónde pintar.

Practica

BásicoReemplaza esta «divitis» por landmarks semánticos: <div class="cabecera">, <div class="menu">, <div class="contenido"> y <div class="pie">.

Ver solución 1
<header>
  <p>Aroma y Punto</p>
  <nav aria-label="Principal">
    <a href="/">Inicio</a> · <a href="/catalogo/">Catálogo</a>
  </nav>
</header>

<main>
  <h1>Café de origen peruano</h1>
  <p>Tostado cada semana en Lima.</p>
</main>

<footer>
  <p>© 2026 Aroma y Punto</p>
</footer>

Con header, nav, main y footer el lector de pantalla ofrece saltos directos a cada zona, y Google entiende qué parte es el contenido principal.

RetoEstructura un blog: dentro de main, dos entradas autónomas (cada una con su encabezado y fecha legible por máquina) y una barra lateral con «Entradas populares». La página tiene además un menú de pie: distingue los dos nav.

Ver solución 2
<nav aria-label="Principal">
  <a href="/">Inicio</a> · <a href="/blog/">Blog</a>
</nav>

<main>
  <article>
    <header>
      <h2>Cómo moler el café en casa</h2>
      <p><time datetime="2026-07-02">2 de julio de 2026</time></p>
    </header>
    <p>La molienda depende del método de preparación…</p>
  </article>

  <article>
    <header>
      <h2>Chanchamayo frente a Cusco</h2>
      <p><time datetime="2026-07-09">9 de julio de 2026</time></p>
    </header>
    <p>Dos valles, dos perfiles de taza…</p>
  </article>

  <aside>
    <h2>Entradas populares</h2>
    <ul>
      <li><a href="/blog/agua-ideal/">El agua ideal para tu café</a></li>
    </ul>
  </aside>
</main>

<footer>
  <nav aria-label="Pie de página">
    <a href="/privacidad/">Privacidad</a> · <a href="/contacto/">Contacto</a>
  </nav>
</footer>

Cada entrada es un article porque tendría sentido sola (en un lector RSS, por ejemplo). Cuando hay varios nav, el aria-label los distingue.

Puntos clave

  • Landmarks: header/nav/main/aside/footer dibujan el mapa.
  • article = autónomo; section = temático con encabezado; div = último recurso.
  • main único por página; nav con aria-label si hay varios.
  • Semántica hoy = SEO, accesibilidad y mantenimiento gratis.

7 · Listas

Intermedio ~10 min

Tres tipos para tres significados — y la lista es la columna vertebral invisible de toda navegación.

Los tres tipos

<ul>                          <!-- desordenada: el ORDEN no importa -->
  <li>Leche evaporada</li>
  <li>Café molido</li>
</ul>

<ol>                          <!-- ordenada: la SECUENCIA importa -->
  <li>Moler el café</li>
  <li value="3">Calentar el agua a 92°C</li>   <!-- continuidad controlada -->
  <li>Servir</li>
</ol>

<dl>                          <!-- descripcion: termino y definicion -->
  <dt>V60</dt>
  <dd>Derivador cono en V, filtro de papel.</dd>
  <dt>French press</dt>
  <dd>Inmersion total, filtro metalico.</dd>
</dl>
TipoSignificadoEjemplos de uso real
<ul>conjunto sin ordenmenús, características, tags
<ol>secuencia con pasosrecetas, rankings, instrucciones
<dl>pares término-definiciónglosarios, FAQ (pregunta/respuesta), metadatos clave-valor

Anidación correcta

<ul>
  <li>
    Café
    <ul>                      <!-- la lista hija vive DENTRO del li padre -->
      <li>Origen</li>
      <li>Mezcla</li>
    </ul>
  </li>
  <li>Té</li>
</ul>

Regla de oro: entre <ul>/<ol> y su <li> NO va nada más. Cualquier texto suelto ahí es HTML inválido que el navegador recolocará a su antojo (y el validador del cap. 30 te lo cobrará).

ol avanzada: start, reversed y value

<ol start="9" reversed>       <!-- cuenta regresiva desde 9 -->
  <li>Podio de finalistas</li>
  <li>Semifinalistas</li>
</ol>

Listas de navegación: el patrón universal

<nav aria-label="Principal">
  <ul>
    <li><a href="/">Inicio</a></li>
    <li><a href="/catalogo">Catálogo</a></li>
    <li><a href="/contacto">Contacto</a></li>
  </ul>
</nav>

Los menús SON listas aunque el CSS las convierta en barras horizontales. El marcado semántico da estructura; la presentación la quita. Un menú hecho de divs sueltos pierde la lectura «lista con 3 elementos» en lectores de pantalla.

Anti-patrón: usar listas solo porque «quedan con vinetas» y luego borrarlas con CSS. Si tu contenido no es una enumeración, usa párrafos — el marcado comunica intención, no apariencia.

Practica

BásicoEscribe la receta del café pasado: una lista de ingredientes (el orden no importa) y otra de pasos (el orden sí importa).

Ver solución 1
<h2>Ingredientes</h2>
<ul>
  <li>20 g de café molido medio</li>
  <li>300 ml de agua a 92 °C</li>
  <li>Filtro de tela o papel</li>
</ul>

<h2>Preparación</h2>
<ol>
  <li>Humedece el filtro con agua caliente.</li>
  <li>Agrega el café y vierte un poco de agua para que «florezca».</li>
  <li>Completa el agua en círculos durante tres minutos.</li>
</ol>

Pregúntate: si cambio el orden, ¿cambia el significado? Si la respuesta es sí, es ol.

RetoCrea (1) un glosario con «Tueste» y «Taza» con sus definiciones, (2) un «Top 3 del mes» que cuente hacia atrás (3, 2, 1) y (3) una lista de orígenes donde «Junín» tenga dentro la sublista «Chanchamayo» y «Satipo».

Ver solución 2
<dl>
  <dt>Tueste</dt>
  <dd>Proceso que transforma el grano verde en café aromático.</dd>
  <dt>Taza</dt>
  <dd>Evaluación sensorial del café preparado.</dd>
</dl>

<ol reversed>
  <li>Geisha de Cusco</li>
  <li>Bourbon de Cajamarca</li>
  <li>Típica de Chanchamayo</li>
</ol>

<ul>
  <li>Junín
    <ul>
      <li>Chanchamayo</li>
      <li>Satipo</li>
    </ul>
  </li>
  <li>Cusco</li>
</ul>

La sublista va DENTRO del li de «Junín», antes de su cierre; nunca como hija directa del ul.

Puntos clave

  • ul = conjunto, ol = secuencia, dl = término-definición.
  • Listas hijas SOLO dentro del li correspondiente.
  • start/reversed/value controlan numeración sin trucos.
  • Todo menú de navegación merece ser una ul dentro de nav.

8 · Tablas de datos

Intermedio ~12 min

Para DATOS tabulares — nunca para maquetar. Bien armada, una tabla se lee sola incluso sin CSS.

La anatomía completa

<table>
  <caption>Stock de café por origen (kg)</caption>
  <thead>
    <tr>
      <th scope="col">Origen</th>
      <th scope="col">Kg</th>
      <th scope="col">Precio S/ kg</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <th scope="row">Chanchamayo</th>
      <td>120</td>
      <td>28.00</td>
    </tr>
    <tr>
      <th scope="row">Cajamarca</th>
      <td>85</td>
      <td>32.50</td>
    </tr>
  </tbody>
</table>

Piezas que la mayoría omite

  • <caption>: título OFICIAL de la tabla — primer contacto del lector de pantalla («tabla con 3 columnas, stock de café…»). No lo sustituye un h2 cercano.
  • scope="col"/"row": declara si ese th nombra columna o fila. Es lo que permite a NVDA decir «Cajamarca, 85» en vez de «85, 85, 85».
  • <thead>/<tbody>/<tfoot>: agrupan para estilos fijos, scroll y para que el total (tfoot) quede semánticamente separado.

Combinar celdas: colspan y rowspan

<tr>
  <th colspan="2">Ventas por canal</th>   <!-- ocupa 2 columnas -->
  <td>S/ 15 400</td>
</tr>
<tr>
  <td>Tienda web</td>
  <td rowspan="2">Ver detalle consolidado</td>  <!-- baja 2 filas -->
  <td>8 200</td>
</tr>

Con celdas combinadas complejas, los lectores de pantalla pierden el mapa aunque uses scope — para datos muy anidados considera varias tablas simples.

Cuándo NO usar tabla

TentaciónHerramienta correcta
«Maquetar» el formulario o la páginaCSS Grid/Flexbox (era pre-historia)
Lista de tarjetas de productosul + CSS grid
Datos que en móvil no caben y «se arreglan» con scroll horizontal eternoreplantear como dl/tarjetas; o tabla solo en desktop + resumen en móvil

La prueba: ¿tus datos tienen RELACIÓN fila-columna real (cruce de valores)? Sí → table. Son solo ítems apilados → otra cosa.

Móvil sin romper nada: patrón mínimo

<div class="table-responsive">   <!-- wrapper con overflow-x auto (Bootstrap) -->
  <table>...</table>
</div>
Puente al curso PHP: cuando tu API REST devuelva listados, esta estructura (thead + tbody + th scope) es la que renderizarás con fetch. Semántica ahora = menos trabajo después.

Practica

BásicoConstruye la tabla «Precios por kilo» con título visible, una fila de encabezados (Producto, Origen, Precio) y tres productos.

Ver solución 1
<table>
  <caption>Precios por kilo</caption>
  <thead>
    <tr>
      <th scope="col">Producto</th>
      <th scope="col">Origen</th>
      <th scope="col">Precio</th>
    </tr>
  </thead>
  <tbody>
    <tr><td>Típica lavado</td><td>Chanchamayo</td><td>S/ 58.00</td></tr>
    <tr><td>Bourbon</td><td>Cajamarca</td><td>S/ 64.00</td></tr>
    <tr><td>Geisha</td><td>Cusco</td><td>S/ 120.00</td></tr>
  </tbody>
</table>

caption es el título de la tabla y scope="col" le dice al lector de pantalla que esa celda encabeza la columna.

RetoHaz el «Resumen de ventas de julio»: filas por origen con encabezado de fila, una celda «Junín» que abarque dos filas (Chanchamayo y Satipo) y un pie con el total que ocupe las dos primeras columnas.

Ver solución 2
<table>
  <caption>Resumen de ventas de julio (kg)</caption>
  <thead>
    <tr><th scope="col">Región</th><th scope="col">Valle</th><th scope="col">Kilos</th></tr>
  </thead>
  <tbody>
    <tr><th scope="row" rowspan="2">Junín</th><td>Chanchamayo</td><td>120</td></tr>
    <tr><td>Satipo</td><td>80</td></tr>
    <tr><th scope="row">Cusco</th><td>La Convención</td><td>45</td></tr>
  </tbody>
  <tfoot>
    <tr><th scope="row" colspan="2">Total</th><td>245</td></tr>
  </tfoot>
</table>

Con rowspan="2" la fila siguiente tiene una celda menos: «Satipo» ocupa la columna Valle porque Junín ya llena la primera.

Puntos clave

  • Solo para datos tabulares reales; caption siempre.
  • scope col/row convierte celdas en frases comprensibles.
  • tfoot para totales; thead para encabezados persistentes.
  • Móvil: wrapper responsive, no tablas maquetadoras.

9 · Contenido embebido: iframes seguros

Intermedio ~10 min

Páginas vivas dentro de tu página: mapas, videos y formularios de terceros — sin abrirle la puerta a todo.

<iframe src="https://www.google.com/maps/embed?pb=..."
        title="Mapa de la tienda en San Isidro"
        width="600" height="450"
        loading="lazy"
        referrerpolicy="no-referrer-when-downgrade"
        allowfullscreen></iframe>

Los atributos que importan

AtributoPor qué
titleel iframe es un elemento interactivo SIN texto: los lectores de pantalla necesitan saber qué contiene
loading="lazy"el mapa NO se carga hasta acercarse al scroll: cada embed pesa megas
referrerpolicycontrola cuánto de tu URL recibe el tercero
sandboxjaula de permisos (ver abajo) — crítica con contenido no confiable

sandbox: permisos uno por uno

<!-- jaula maxima: scripts bloqueados, forms bloqueados, mismo origen NO -->
<iframe sandbox src="https://demo.ejemplo.pe/widget.html"></iframe>

<!-- conceder SOLO lo necesario -->
<iframe sandbox="allow-scripts allow-forms"
        src="https://encuestas.ejemplo.pe/valoracion"></iframe>
  • allow-scripts: ejecuta JS (sin él, un widget muere).
  • allow-forms: permite enviar formularios internos.
  • allow-same-origin: PELIGROSO junto a allow-scripts — el embed podría quitarse su propio sandbox. Solo con contenido de confianza absoluta.
  • Todo lo no listado queda DENEGADO: popups, descargas, navegación de tu página.

Embeds típicos y sus patrones

ServicioPatrón seguro
YouTubeusa el código «Insertar» oficial (ya trae lazy si activas la casilla); considera la fachada de miniatura + clic (carga real solo al pedirlo)
Google MapsCompartir → Insertar un mapa; añade loading="lazy" y title descriptivo
Widgets de pago/redesrevisa SIEMPRE qué piden; si exigen allow-same-origin + scripts, aísla esa página aparte

Fachada (facade): el truco de rendimiento

<!-- 1. solo una miniatura local (KB, no MB) -->
<a href="https://www.youtube.com/watch?v=XXXX" target="_blank" rel="noopener">
  <img src="img/video-portada.webp" alt="Ver: perfil de tueste explicado"
       width="1280" height="720">
</a>

<!-- 2. el iframe REAL se inyecta con JS solo tras el clic -->

Un embed de YouTube puede costar ~2 MB de JS propio. Con fachada, tu LCP ni se entera. Es el patrón que usan los sitios serios.

Puente a seguridad: el cap. 35 de js_01 trató postMessage entre ventanas: los iframes SON ese canal. Aquí viste cómo limitarlos desde HTML; allí, cómo comunicarse con ellos verificando origen.

Practica

BásicoInserta el mapa de la tienda desde https://www.openstreetmap.org/export/embed.html?bbox=-77.04,-12.05,-77.02,-12.04 de forma accesible y sin que frene la carga inicial.

Ver solución 1
<iframe src="https://www.openstreetmap.org/export/embed.html?bbox=-77.04,-12.05,-77.02,-12.04"
        title="Mapa de la tienda Aroma y Punto en el centro de Lima"
        width="600" height="400" loading="lazy"></iframe>

title es obligatorio: es lo que anuncia el lector de pantalla al entrar al iframe.

RetoVas a mostrar el widget de un proveedor (https://widgets.ejemplo.pe/tasa.html) que necesita ejecutar JavaScript y enviar un formulario, pero no debe leer tus cookies ni abrir ventanas. Configura el sandbox mínimo y explica por qué no agregas allow-same-origin.

Ver solución 2
<iframe src="https://widgets.ejemplo.pe/tasa.html"
        title="Tipo de cambio del día"
        width="320" height="180" loading="lazy"
        sandbox="allow-scripts allow-forms"
        referrerpolicy="no-referrer"></iframe>

sandbox vacío lo niega todo; aquí concedes solo dos permisos. Con allow-same-origin y allow-scripts juntos, un contenido del mismo origen podría quitarse el sandbox: el aislamiento dejaría de servir.

Puntos clave

  • Iframe = página ajena corriendo en la tuya: title + lazy obligatorios.
  • sandbox niega TODO por defecto; concede mínimo necesario.
  • Fachada de imagen para embeds pesados: MB→KB.
  • allow-same-origin + allow-scripts juntos = sandbox inútil.

10 · Interactivos modernos sin JavaScript

Intermedio ~13 min

Acordeones, modales y popups que antes pedían librerías: hoy son etiquetas nativas, accesibles y sin dependencias.

details/summary: el acordeón gratis

<details>
  <summary>¿Hacen envíos a provincia?</summary>
  <p>Sí — Lima 24 h, provincias 2 a 5 días vía Olva.</p>
</details>

<details open>                    <!-- abierto por defecto -->
  <summary>Medios de pago</summary>
  <ul><li>Yape/Plin</li><li>Tarjetas</li></ul>
</details>
  • Teclado y lectores de pantalla: funcionan solos. Cero JS.
  • El contenido NO indexado-cerrado igual pertenece al DOM (Google lo lee).
  • Ideal FAQ, filtros colapsables, «leer más» técnicos.

dialog: el modal nativo

<button id="abrir">Eliminar producto</button>

<dialog id="confirmar">
  <h2>¿Seguro?</h2>
  <p>Esta acción no se puede deshacer.</p>
  <form method="dialog">         <!-- cierra el dialog sin recargar -->
    <button value="cancelar">Cancelar</button>
    <button value="si" class="btn-danger">Sí, eliminar</button>
  </form>
</dialog>
// TODO el JS necesario:
const dlg = document.getElementById("confirmar");
document.getElementById("abrir").onclick = () => dlg.showModal();
dlg.addEventListener("close", () => console.log("elegido:", dlg.returnValue));
  • showModal(): fondo oscurecido (::backdrop), foco ATRAPADO dentro, tecla ESC cierra — las tres cosas que toda librería de modales reimplementa mal.
  • form method="dialog" devuelve el value del botón pulsado en returnValue — confirmaciones sin estados extra.

popover: tooltips y menús declarativos

<button popovertarget="carrito-menu">Mi carrito (2)</button>

<div id="carrito-menu" popover>     <!-- light-dismiss: clic fuera cierra -->
  <ul>
    <li>2x Café Chanchamayo</li>
    <li>1x Prensa francesa</li>
  </ul>
  <a href="/carrito">Ir al carrito</a>
</div>
  • Cero JS para abrir/cerrar; clic fuera y ESC cierran (light dismiss).
  • Vive en la capa top-layer: adiós z-index wars.
  • popover="manual" para control fino desde JS cuando haga falta.

search: agrupar lo buscable

<search>                          <!-- landmark: region de busqueda -->
  <form action="/buscar">
    <label for="q">Buscar productos</label>
    <input id="q" name="q" type="search">
    <button>Buscar</button>
  </form>
</search>
NecesidadNativoJS requerido
Acordeón / FAQdetails+summaryninguno
Modal con confirmacióndialog2 líneas (open/close)
Menú contextual / tooltip ricopopoverninguno
Zona de búsquedasearchninguno

Practica

BásicoCrea una sección de preguntas frecuentes con dos preguntas desplegables, sin JavaScript. La primera debe aparecer abierta.

Ver solución 1
<h2>Preguntas frecuentes</h2>

<details open>
  <summary>¿Hacen envíos a provincias?</summary>
  <p>Sí, a todo el Perú en 48 a 72 horas.</p>
</details>

<details>
  <summary>¿El café viene molido?</summary>
  <p>Tú eliges: en grano o con la molienda de tu método.</p>
</details>

El atributo open controla el estado inicial; el usuario abre y cierra el resto con teclado o toque.

RetoAgrega (1) un menú de ayuda que se abra con un botón usando popover (sin JavaScript) y (2) un modal de confirmación con <dialog> abierto con showModal(), cuyo botón «Cerrar» lo cierre sin código extra.

Ver solución 2
<button type="button" popovertarget="ayuda">Ayuda</button>
<div id="ayuda" popover>
  <p>Escríbenos por WhatsApp de 8:00 a 20:00.</p>
</div>

<button type="button" id="abrir">Vaciar carrito</button>
<dialog id="confirmar">
  <form method="dialog">
    <p>¿Seguro que quieres vaciar el carrito?</p>
    <button value="si">Sí, vaciar</button>
    <button value="no">Cerrar</button>
  </form>
</dialog>

<script>
  document.getElementById('abrir').addEventListener('click', () => {
    document.getElementById('confirmar').showModal();
  });
</script>

Un formulario con method="dialog" cierra el modal al enviarse, y el value del botón pulsado queda en dialog.returnValue. showModal() trae gratis el foco atrapado, la tecla ESC y el fondo.

Puntos clave

  • Antes librería, hoy etiqueta: details, dialog, popover.
  • showModal trae foco atrapado + ESC + backdrop gratis.
  • popover con light-dismiss vive sobre todos los z-index.
  • Menos JS = menos peso, menos bugs, mejor accesibilidad.

11 · Atributos globales y data-*

Intermedio ~12 min

Atributos que CUALQUIER elemento acepta — y el puente oficial entre tu markup y JavaScript.

El kit global

AtributoFunción realOjo con…
ididentidad ÚNICA: anclas, label-for, getElementByIdduplicados = bugs silenciosos; no uses id para estilar (eso es class)
classpertenencia a grupos: estilos y selección múltiplenombres por ROL (.btn-danger), no por aspecto (.rojo)
hiddenocultar semánticamente (no se renderiza)si tu CSS display:block le «gana», rompes su contrato — evita sobreescribirlo
titletooltip nativo al hoversolo info complementaria; NO accesible por teclado/táctil
langidioma de ese fragmentocitas en otro idioma: <q lang="en">less is more</q>
dir="rtl"dirección de escrituracontenidos árabe/hebreo embebidos
contenteditableeditable en vivoeditores rápidos, demos; guarda validando siempre
tabindex="0"mete un no-interactivo al orden de tabulacióncon moderación: cada tabindex positivo custom = orden roto

data-*: atributos TUYOS sin romper nada

<button class="btn-agregar"
        data-sku="CAF-01"
        data-nombre="Café Chanchamayo"
        data-precio="28.00">
  Agregar al carrito
</button>

HTML ignora cualquier atributo que empiece con data-: son tuyos. JavaScript los lee como propiedades camelCase del dataset:

// eco directo del cap. 32 de js_01
document.querySelectorAll(".btn-agregar").forEach(btn => {
  btn.addEventListener("click", () => {
    carrito.agregar({
      sku: btn.dataset.sku,           // data-sku
      nombre: btn.dataset.nombre,     // data-nombre
      precio: parseFloat(btn.dataset.precio),
    });
  });
});
  • Convención de nombres: data-id-producto → dataset.idProducto.
  • Perfectos para estado INICIAL; para estado que cambia mucho, mejor JS puro.
  • Son públicos e inspeccionables: NUNCA tokens, precios sensibles ni PII.

El patrón Bootstrap que ya usas

<button data-bs-toggle="collapse" data-bs-target="#filtros">
  Filtros
</button>

<div id="filtros" class="collapse">...</div>

Bootstrap 5 entero funciona sobre data-*: declaras el comportamiento EN EL MARKUP y la librería lo interpreta. Escribir data-* propios sigue exactamente esa filosofía — HTML descriptivo, JS genérico.

Puente al curso JS: dataset ya apareció en el cap. 32 de js_01 (selección y mutación del DOM). Aquí viste la cara HTML del mismo contrato: quien escribe el markup decide qué datos viajan pegados al elemento.

Estilo vs significado: el test del renombre

Cambia tu paleta completa: ¿.btn-rojo se volvió mentira? Los nombres por rol (.btn-peligro, .tarjeta-destacada) sobreviven a cualquier rediseño. El atributo class describe QUÉ ES, no CÓMO SE PINTA.

Practica

BásicoMarca la tarjeta de un producto con un id único, una clase de grupo y tres metadatos propios: código TIP-01, precio 58 y stock 12.

Ver solución 1
<article id="producto-tip01" class="producto"
         data-codigo="TIP-01" data-precio="58" data-stock="12">
  <h2>Típica lavado · Chanchamayo</h2>
  <p>S/ 58.00 el kilo</p>
</article>

id identifica a UN elemento; class agrupa elementos con el mismo rol; data-* guarda tus datos sin inventar atributos.

RetoAgrega a la tarjeta el atributo data-precio-unitario="58" y escribe un script que lo lea con dataset y muestre en un párrafo el precio de 3 kilos.

Ver solución 2
<article id="producto-tip01" class="producto" data-precio-unitario="58">
  <h2>Típica lavado · Chanchamayo</h2>
  <p id="total"></p>
</article>

<script>
  const tarjeta = document.getElementById('producto-tip01');
  const precio = Number(tarjeta.dataset.precioUnitario);   // data-precio-unitario → precioUnitario
  document.getElementById('total').textContent = `3 kg: S/ ${(precio * 3).toFixed(2)}`;
</script>

Los guiones se convierten a camelCase en dataset. Todo llega como texto: por eso Number() antes de multiplicar.

Puntos clave

  • id único para identidad; class para grupos por rol.
  • hidden es semántico; title nunca lleva info crítica.
  • data-* = metadatos privados tuyos; dataset los lee en camelCase.
  • Jamás secretos ni datos personales en data-*.

12 · Formularios I: el contrato form-label-name

Intermedio ~13 min

El puente oficial HTML→PHP: tres piezas que todo formulario necesita para que los datos LLEGUEN.

<form action="/api/contacto.php" method="POST">

  <label for="correo">Correo</label>
  <input id="correo" name="correo" type="email">

  <label for="mensaje">Mensaje</label>
  <textarea id="mensaje" name="mensaje"></textarea>

  <button type="submit">Enviar consulta</button>
</form>

La regla de oro: sin name, no viaja

Lo que llega al servidor es el par nombre=valor — y ese nombre sale EXCLUSIVAMENTE del atributo name. El id sirve para label/CSS/JS, pero al servidor no le importa. Un input sin name es invisible para PHP:

Marcas…Llega a $_POST
<input name="correo">$_POST["correo"]
<input id="correo"> (sin name)NADA — no existe para el servidor
<input name="user[correo]">$_POST["user"]["correo"] — arrays automáticos

label: obligatorio y bien amarrado

<!-- forma explicita (preferida): for apunta al id -->
<label for="tel">Celular</label>
<input id="tel" name="tel" type="tel">

<forma implicita: el input vive dentro del label -->
<label>Ciudad <input name="ciudad"></label>
  • Clic en el label enfoca el campo (área táctil más grande).
  • Sin label, el lector de pantalla dice «editar texto» sin saber de qué.
  • Un label POR campo; el texto descriptivo va FUERA del placeholder.

method GET vs POST: la decisión de arquitectura

GETPOST
Datos viajan en…URL (?q=cafe&pag=2)cuerpo HTTP (invisible en URL)
PHP lo lee en…$_GET$_POST
Se puede marcar/recargarsí (búsqueda, filtros)recargar re-envía (pedidos, pagos)
VolumenURLs limitadas ~2 KBmegas (y archivos: solo POST)
Usa para…CONSULTAR/buscar/filtrarCAMBIAR estado (crear, borrar, pagar)

Regla del manual PHP repetida aquí: GET nunca cambia nada; POST nunca debería poder pedirse dos veces por accidente.

Los tres tipos de button

<button type="submit">Enviar</button>       <!-- default: dispara el form -->
<button type="reset">Limpiar</button>      <!-- restaura valores iniciales -->
<button type="button">Vista previa</button> <!-- no hace NADA sin JS -->
Bug clásico: un botón auxiliar sin type="button" dentro del form envía TODO por accidente. Decláralo siempre.

El flujo completo visto desde arriba

  1. Usuario llena y pulsa submit → navegador arma pares nombre=valor.
  2. Los codifica (urlencoded o multipart — cap. 16 para archivos).
  3. PHP recibe en $_GET/$_POST → valida DE NUEVO → responde.
  4. La respuesta puede ser página completa (clásico) o JSON (fetch, cap. 36 js_01).

Practica

BásicoCrea un buscador del catálogo que envíe la palabra buscada a /buscar con el nombre q, con etiqueta amarrada al campo.

Ver solución 1
<form action="/buscar" method="get">
  <label for="q">Buscar café</label>
  <input type="search" id="q" name="q">
  <button type="submit">Buscar</button>
</form>

Con GET la búsqueda queda en la URL (/buscar?q=geisha): se puede compartir y guardar en favoritos.

RetoCrea el formulario «Suscríbete» que envíe nombre y correo por POST a /suscripciones, con un botón para enviar y otro auxiliar «Ver ejemplo de boletín» que NO envíe el formulario.

Ver solución 2
<form action="/suscripciones" method="post">
  <label for="nombre">Nombre</label>
  <input type="text" id="nombre" name="nombre">

  <label for="correo">Correo</label>
  <input type="email" id="correo" name="correo">

  <button type="button" id="ejemplo">Ver ejemplo de boletín</button>
  <button type="submit">Suscribirme</button>
</form>

Un button dentro de un form es submit por defecto: el auxiliar necesita type="button" o enviará el formulario. POST porque la acción CAMBIA datos en el servidor.

Puntos clave

  • name es el contrato con el servidor; sin name no hay dato.
  • label-for amarrado: accesibilidad + área táctil.
  • GET consulta, POST cambia; archivos exigen POST.
  • Auxiliares SIEMPRE type="button".

13 · Controles de texto a fondo

Intermedio ~14 min

Siete sabores de input de texto y las propiedades que los doman — con la diferencia readonly/disabled que casi nadie explica bien.

Los siete tipos y su especialidad

TipoEspecialidadValidación gratis
texttexto libre generalninguna
emailcorreos (uno o varios con multiple)formato básico de correo
urldirecciones webdebe tener esquema (https://…)
teltélefonos (sin formato fijo internacional)ninguna — combínala con pattern (cap. 15)
searchbúsquedas: borra con una X, Enter disparaninguna
passwordoculta caracteres (NO cifra: eso hace HTTPS)ninguna
hiddenvalor invisible que viaja (token CSRF, ids)el usuario no lo ve ni edita

El tipo correcto te regala teclado adecuado en móvil, autocompletado del navegador y primera línea de validación — todo por escribir una palabra.

Propiedades que importan

<input type="text" name="titulo"
       value="Pedido pendiente"          <!-- valor INICIAL (editable) -->
       maxlength="80"                    <!-- tope duro de caracteres -->
       placeholder="Ej: entrega Jockey Plaza"
       required>
PropiedadHace…Nota fina
valuevalor inicial del controlen PHP: repoblar tras error de validación
placeholderejemplo/hint mientras está vacíoNUNCA sustituye al label (desaparece al escribir)
minlength / maxlengthrango de caracteresmaxlength corta; minlength VALIDA (con required)
spellcheckcorrector nativo on/offoff para correos, códigos, nombres propios raros
autocompleteautollenado semánticotokens estándar: name, email, tel, postal-code…
inputmodeteclado móvil preferidonumeric, decimal, tel, email, url, search
readonlysolo lectura PERO viaja al servidordatos calculados que deben llegar a PHP
disabledapagado total: NO viaja al servidorideal para «lo desactivo hasta que…»
readonly vs disabled — la trampa de examen: ambos impiden editar, pero disabled saca el campo del envío. Un total calculado marcado disabled llegará como NULL a tu PHP. Si el dato debe viajar: readonly.

autocomplete: menos tipeo, más conversiones

<input name="nombre"   autocomplete="name">
<input name="correo"   type="email"    autocomplete="email">
<input name="celular"  type="tel"      autocomplete="tel national">
<input name="dir"      autocomplete="street-address">
<input name="cp"       autocomplete="postal-code" inputmode="numeric">

Con tokens correctos, el celular propone SUS datos en un toque y tu formulario deja de perder gente en el paso de pago. Es UX pura gratis.

textarea: el primo multilinea

<textarea name="direccion" rows="3"
          placeholder="Av. Arequipa 1234, dpto 501"
          maxlength="250">Valor inicial aqui</textarea>
  • No tiene value: el valor inicial es su CONTENIDO.
  • rows sugiere altura; el usuario puede redimensionar (resize con CSS si molesta).
  • Preserva saltos de línea: en PHP, nl2br() los muestra de vuelta.

Practica

BásicoArma el formulario de registro con correo, celular, sitio web y una contraseña NUEVA, usando el type y el autocomplete correctos para cada campo.

Ver solución 1
<form action="/registro" method="post">
  <label for="correo">Correo</label>
  <input type="email" id="correo" name="correo" autocomplete="email">

  <label for="celular">Celular</label>
  <input type="tel" id="celular" name="celular" autocomplete="tel" placeholder="987 654 321">

  <label for="web">Sitio web</label>
  <input type="url" id="web" name="web" autocomplete="url">

  <label for="clave">Contraseña</label>
  <input type="password" id="clave" name="clave" autocomplete="new-password">

  <button type="submit">Crear cuenta</button>
</form>

El type cambia el teclado del celular; new-password le pide al navegador sugerir una clave segura.

RetoEn el formulario de reclamo: (1) un DNI que muestre teclado numérico, (2) un comentario multilínea de máximo 500 caracteres, (3) el código de pedido PED-0042 visible y que SÍ viaje al servidor, y (4) un campo «Tienda» informativo que NO viaje.

Ver solución 2
<form action="/reclamos" method="post">
  <label for="dni">DNI</label>
  <input type="text" id="dni" name="dni" inputmode="numeric" autocomplete="off">

  <label for="comentario">Cuéntanos qué pasó</label>
  <textarea id="comentario" name="comentario" rows="4" maxlength="500"></textarea>

  <label for="pedido">Pedido</label>
  <input type="text" id="pedido" name="pedido" value="PED-0042" readonly>

  <label for="tienda">Tienda</label>
  <input type="text" id="tienda" value="Lima Centro" disabled>

  <button type="submit">Enviar reclamo</button>
</form>

readonly no se edita pero viaja; disabled no se edita ni viaja. El DNI usa type="text" + inputmode="numeric" porque no es una cantidad (un DNI puede empezar con 0).

Puntos clave

  • type correcto = teclado + autocompletar + validación base.
  • placeholder ejemplifica; label etiqueta. Nunca lo mismo.
  • readonly viaja, disabled NO — decide con el envío en mente.
  • autocomplete + inputmode son conversión pura en móvil.

14 · Números, fechas y selección

Intermedio ~13 min

Controles con estado propio: sliders, calendarios nativos y la mecánica exacta de radio/checkbox/select hacia PHP.

Números y rangos

<input type="number" name="cantidad"
       min="1" max="99" step="1" inputmode="numeric">

<input type="range" name="distancia" min="0" max="50" step="5"
       oninput="this.nextElementSibling.value = this.value + ' km'">
<output>10 km</output>
  • min/max/step validan solos: 7 con step=5 es inválido.
  • number sigue aceptando «e» (notación científica): valida también en servidor.
  • <output> es el compañero semántico del range.

Fechas y horas nativas

<input type="date"         name="desde" min="2026-01-01">
<input type="time"         name="hora">
<input type="datetime-local" name="reserva">
<input type="month"        name="corte">

El navegador muestra el CALENDARIO en el formato regional del usuario, pero ENVÍA siempre ISO: 2026-08-23. PHP lo parsea sin dramas (new DateTime($_POST["desde"])). Cero librerías de datepicker.

checkbox: casillas independientes

<input type="checkbox" id="promo" name="promo" value="si">
<label for="promo">Quiero promociones</label>

<!-- varios con el MISMO nombre + corchetes = array en PHP -->
<input type="checkbox" name="extras[]" value="leche">
<input type="checkbox" name="extras[]" value="edulcorante">
EstadoLo que llega a PHP
marcado, value="si"$_POST["promo"] === "si"
desmarcadoNO llega — ni siquiera existe la clave (isset!)
extras[]: dos marcados$_POST["extras"] = ["leche","edulcorante"]

El detalle que rompe principiantes: un checkbox apagado NO envía nada. En PHP comprueba con isset(), nunca esperes cadena vacía.

radio: UNA opción por grupo

<fieldset>
  <legend>Tamaño</legend>
  <input type="radio" id="t-s" name="tamano" value="S">
  <label for="t-s">Small S/12</label>

  <input type="radio" id="t-m" name="tamano" value="M" checked>
  <label for="t-m">Medium S/16</label>

  <input type="radio" id="t-l" name="tamano" value="L">
  <label for="t-l">Large S/19</label>
</fieldset>
  • Mismo name = mismo grupo: elegir uno desmarca los demás.
  • Sin opción marcada, el grupo no viaja — usa checked para proponer default.
  • fieldset+legend nombra al grupo para lectores de pantalla.

select y datalist

<label for="cat">Categoría</label>
<select id="cat" name="categoria">
  <option value="" disabled selected>Elegir…</option>
  <optgroup label="Bebidas">
    <option value="cafe">Café</option>
    <option value="te">Té</option>
  </optgroup>
  <optgroup label="Accesorios">
    <option value="prensa">Prensas</option>
  </optgroup>
</select>

<!-- datalist: texto libre CON sugerencias -->
<input name="ciudad" list="ciudades-pe">
<datalist id="ciudades-pe">
  <option value="Lima"><option value="Arequipa"><option value="Cusco">
</datalist>
  • select: respuesta cerrada garantizada; multiple permite varias opciones → nómbralo categorias[] para recibir array en PHP.
  • datalist: el usuario puede escribir algo NO listado — úsalo cuando la lista es ayuda, no regla.

Practica

BásicoPara un pedido: cantidad de kilos entre 1 y 20 (de uno en uno), fecha de entrega y tipo de molienda a elegir entre «Grano», «Media» y «Fina».

Ver solución 1
<form action="/pedidos" method="post">
  <label for="kilos">Kilos</label>
  <input type="number" id="kilos" name="kilos" min="1" max="20" step="1" value="1">

  <label for="entrega">Fecha de entrega</label>
  <input type="date" id="entrega" name="entrega">

  <label for="molienda">Molienda</label>
  <select id="molienda" name="molienda">
    <option value="grano">Grano</option>
    <option value="media">Media</option>
    <option value="fina">Fina</option>
  </select>

  <button type="submit">Pedir</button>
</form>

El date se muestra en el formato regional del usuario, pero llega al servidor como 2026-07-15 (ISO).

RetoAgrega al pedido: extras opcionales (taza y filtro, que el servidor reciba como lista), el método de pago (solo uno: Yape o tarjeta) agrupado y con nombre accesible, y un campo «Distrito» con sugerencias.

Ver solución 2
<fieldset>
  <legend>Extras</legend>
  <input type="checkbox" id="taza" name="extras[]" value="taza">
  <label for="taza">Taza de cerámica</label>
  <input type="checkbox" id="filtro" name="extras[]" value="filtro">
  <label for="filtro">Filtro de tela</label>
</fieldset>

<fieldset>
  <legend>Método de pago</legend>
  <input type="radio" id="yape" name="pago" value="yape" required>
  <label for="yape">Yape</label>
  <input type="radio" id="tarjeta" name="pago" value="tarjeta">
  <label for="tarjeta">Tarjeta</label>
</fieldset>

<label for="distrito">Distrito</label>
<input id="distrito" name="distrito" list="distritos">
<datalist id="distritos">
  <option value="Miraflores"></option>
  <option value="San Isidro"></option>
  <option value="Surco"></option>
</datalist>

Los radios del mismo grupo comparten name; extras[] hace que PHP reciba un arreglo. Una casilla sin marcar no viaja: en el servidor se comprueba con isset().

Puntos clave

  • Fechas: UI regional, envío ISO — PHP feliz.
  • Checkbox off NO viaja: isset() en PHP.
  • name[]=arrays: extras[] y categorias[] llegan como listas.
  • fieldset/legend nombran grupos de radio para a11y.

15 · Validación nativa y expresiones regulares

Avanzado ~16 min

El navegador valida ANTES de enviar si tú sabes pedirlo: required, min/max y sobre todo pattern con regex.

Las reglas declarativas

<form>
  <input name="sku" required minlength="6" maxlength="12"
         pattern="[A-Z]{3}-[0-9]{4}"
         title="Formato: tres mayusculas, guion y 4 digitos. Ej: CAF-0001">

  <input name="precio" type="number" min="0.50" max="9999" step="0.10">

  <textarea name="nota" required minlength="10"></textarea>

  <button>Registrar</button>
</form>
  • Pulsar submit con algo inválido: el navegador BLOQUEA el envío, enfoca el campo y muestra su globo de error (que usa el atributo title como explicación).
  • Es UX instantánea — pero NUNCA seguridad: el servidor revalida SIEMPRE (cualquiera abre DevTools y borra tus patterns).

pattern: regex con dos reglas propias

El patrón se compila con sintaxis JavaScript (como /…/u) pero:

  1. Sin barras: escribes [0-9]{8}, no /[0-9]{8}/.
  2. Anclaje implícito: se compara contra el valor COMPLETO — es como si llevara ^(…)$ invisible. Un pattern [0-9]{8} rechaza «123456789» aunque contenga ocho dígitos.

Mini-guía de lectura

PiezaSignifica…
[0-9] o \dun dígito cualquiera
[A-Za-z]cualquier letra (sin tildes: cuidado con ñ)
{8} / {2,4} / {2,}exactamente 8 / entre 2 y 4 / al menos 2
* / + / ?0 o más / 1 o más / opcional (una vez)
|alternativa: (10|20) — diez o veinte
()grupo: aplica cuantificadores y alternancias al bloque
\.punto literal (sin escape, "." significa «cualquier carácter»)
\sespacio, tab o salto de línea

Patrones peruanos listos para copiar

<!-- DNI: exactamente 8 digitos -->
<input name="dni" inputmode="numeric" pattern="[0-9]{8}"
       title="DNI son 8 digitos">

<!-- Celular: empieza en 9 y tiene 9 digitos -->
<input name="cel" type="tel" inputmode="numeric" pattern="9[0-9]{8}"
       title="Celular: 9 digitos empezando en 9. Ej: 987654321">

<!-- Placa auto (formato clasico): ABC-123 -->
<input name="placa" pattern="[A-Z0-9]{3}-[0-9]{3}"
       title="Formato AAA-000" style="text-transform:uppercase">

<!-- RUC: 11 digitos empezando en 10 (natural) o 20 (juridica) -->
<input name="ruc" inputmode="numeric" pattern="(10|20)[0-9]{9}"
       title="RUC: 11 digitos, inicia en 10 o 20">

<!-- SKU interno del curso: CAF-0001 -->
<input name="sku" pattern="[A-Z]{3}-[0-9]{4}">

<!-- Hora 24h: 08:30, 23:59 -->
<input name="hora" pattern="([01][0-9]|2[0-3]):[0-5][0-9]" placeholder="HH:MM">
Tres errores típicos: poner ^/$ dentro del pattern (sobran: ya están implícitos); dejar espacios accidentales tras las comillas (¡el espacio cuenta!); y confiar en [A-Z] para nombres — la ñ y tildes viven FUERA de A-Z (usa clases Unicode o valida en servidor con mb_).

Mensajes de error humanos

// el globo nativo es feo pero funcional; personalizar cuando valga la pena:
const dni = document.forms.registro.dni;
dni.addEventListener("invalid", () =>
  dni.setCustomValidity(dni.value === "" ? "El DNI es obligatorio"
                                         : "Un DNI tiene 8 dígitos"));
dni.addEventListener("input", () => dni.setCustomValidity(""));  // limpiar al tipear

En CSS, :user-invalid pinta SOLO los campos que el usuario ya tocó mal — evita pintar todo de rojo antes de que escriba.

Practica

BásicoValida con atributos nativos: nombre obligatorio de al menos 2 caracteres y DNI obligatorio de exactamente 8 dígitos, con un mensaje que explique el formato.

Ver solución 1
<form action="/clientes" method="post">
  <label for="nombre">Nombre</label>
  <input type="text" id="nombre" name="nombre" required minlength="2">

  <label for="dni">DNI</label>
  <input type="text" id="dni" name="dni" inputmode="numeric" required
         pattern="\d{8}" title="8 dígitos, sin puntos ni espacios">

  <button type="submit">Guardar</button>
</form>

pattern se escribe sin barras y ya exige el valor COMPLETO (las anclas ^ y $ son implícitas).

RetoEscribe los patrones para: celular peruano (9 dígitos que empiezan con 9), RUC (11 dígitos que empiezan con 10 o 20) y un nombre que acepte tildes, ñ y espacios (2 a 40 caracteres).

Ver solución 2
<label for="cel">Celular</label>
<input type="tel" id="cel" name="cel" pattern="9\d{8}" title="9 dígitos, empieza con 9">

<label for="ruc">RUC</label>
<input type="text" id="ruc" name="ruc" inputmode="numeric" pattern="(10|20)\d{9}"
       title="11 dígitos: empieza con 10 (persona) o 20 (empresa)">

<label for="nom">Nombre completo</label>
<input type="text" id="nom" name="nom" pattern="[A-Za-zÁÉÍÓÚÜáéíóúüÑñ ]{2,40}"
       title="Solo letras y espacios, de 2 a 40 caracteres">

[A-Za-z] no incluye la ñ ni las tildes: en español real hay que agregarlas. Recuerda que el servidor debe volver a validar: el cliente valida para la experiencia, el servidor para la seguridad.

Puntos clave

  • pattern sin barras y con anclas implícitas: casa el valor COMPLETO.
  • title explica el formato esperado: alimenta el globo nativo.
  • Cliente valida para UX; servidor revalida por seguridad.
  • A-Z no incluye ñ/tildes: piensa en español real.

16 · Subida de archivos I: el input file

Intermedio ~13 min

El único control que transporta BITS completos al servidor — con su enctype obligatorio y su mapa hacia $_FILES.

La receta mínima que SÍ funciona

<form action="/api/foto.php" method="POST"
      enctype="multipart/form-data">      <!-- OBLIGATORIO para archivos -->

  <label for="foto">Foto del producto</label>
  <input type="file" id="foto" name="foto" accept="image/*">

  <button>Subir</button>
</form>

Los tres atributos que moldean el control

AtributoFunciónEjemplo
acceptfiltra lo que el diálogo muestra (SUGERENCIA, no seguridad).pdf,.docx / image/png,image/jpeg / image/*
multiplepermite varios archivos a la veznómbralo array: name="fotos[]"
captureen móvil abre cámara directacapture="environment" (trasera) | "user" (frontal)
<!-- galeria multiple -->
<input type="file" name="fotos[]" multiple accept="image/*">

<!-- comprobante PDF desde apps de archivos o escaner -->
<input type="file" name="comprobante" accept=".pdf,image/*">

<!-- selfie directa de camara trasera -->
<input type="file" name="selfie" accept="image/*" capture="environment">

Qué recibe PHP: el mapa de $_FILES

Para el input anterior (name="foto"), PHP arma:

ClaveContenidoUso típico
namenombre ORIGINAL en la máquina del usuariosolo informativo — NUNCA confíes ni reuses tal cual
typeMIME DECLARADO por el navegadorse puede fingir: valida contenido real (cap. 17)
sizebytes recibidostu segunda línea contra archivos monstruo
tmp_nameruta temporal donde PHP ya guardó el archivomove_uploaded_file() lo lleva a su destino final
errorcódigo UPLOAD_ERR_* (0 = OK)SIEMPRE revisarlo antes de mover nada

Con name="fotos[]" + multiple, cada clave se vuelve un ARRAY paralelo: fotos["name"][0], fotos["tmp_name"][0]… El manual PHP cubre move_uploaded_file y validación profunda — aquí dominas la mitad HTML.

Enviar con fetch: FormData hace el multipart

// eco del cap. 36 de js_01 — SIN tocar Content-Type manualmente
form.addEventListener("submit", async (e) => {
  e.preventDefault();
  const r = await fetch("/api/foto.php", {
    method: "POST",
    body: new FormData(form),     // detecta archivos y arma el multipart
  });
  aviso.textContent = r.ok ? "Subida exitosa" : `Error ${r.status}`;
});

Practica

BásicoCrea el formulario «Sube tu foto de perfil» que acepte solo imágenes y envíe el archivo con el nombre foto a /perfil/foto.

Ver solución 1
<form action="/perfil/foto" method="post" enctype="multipart/form-data">
  <label for="foto">Foto de perfil</label>
  <input type="file" id="foto" name="foto" accept="image/*" required>
  <button type="submit">Subir</button>
</form>

Sin method="post" y enctype="multipart/form-data" el archivo no viaja: solo llegaría su nombre.

RetoPermite subir varias fotos JPG, PNG o WebP de un pedido (para que PHP las reciba como arreglo) y envíalas con fetch sin recargar la página, mostrando la respuesta en un párrafo.

Ver solución 2
<form id="evidencias" action="/pedidos/42/fotos" method="post" enctype="multipart/form-data">
  <label for="fotos">Fotos de la entrega</label>
  <input type="file" id="fotos" name="fotos[]" accept=".jpg,.png,.webp" multiple>
  <button type="submit">Enviar fotos</button>
</form>
<p id="estado" aria-live="polite"></p>

<script>
  const form = document.getElementById('evidencias');
  form.addEventListener('submit', async (evento) => {
    evento.preventDefault();
    const respuesta = await fetch(form.action, { method: 'POST', body: new FormData(form) });
    document.getElementById('estado').textContent = respuesta.ok ? 'Fotos recibidas' : 'No se pudo subir';
  });
</script>

FormData arma el multipart por ti: no fijes la cabecera Content-Type, el navegador agrega el boundary correcto.

Puntos clave

  • enctype multipart/form-data o no hay archivo.
  • accept filtra el diálogo; multiple + name[] da arrays.
  • $_FILES trae 5 claves; error y tmp_name son tus amigas.
  • FormData + fetch = subida AJAX sin librerías.

17 · Subida de archivos II: variantes y límites reales

Avanzado ~15 min

Drag & drop, previsualización y la verdad incómoda: quien decide cuánto pesa un archivo es el SERVIDOR, nunca tu HTML.

Zona drag & drop

<label id="zona" for="arrastre"
      style="border:2px dashed #b23117; padding:2rem; display:block;">
  Arrastra tus fotos aqui o haz clic para elegirlas
</label>
<input type="file" id="arrastre" name="fotos[]" multiple accept="image/*" hidden>
const zona = document.getElementById("zona");
const input = document.getElementById("arrastre");

zona.addEventListener("dragover", e => e.preventDefault());   // NECESARIO para soltar
zona.addEventListener("drop", e => {
  e.preventDefault();
  const dt = new DataTransfer();                              // contenedor de FileList
  [...e.dataTransfer.files].forEach(f => {
    if (f.type.startsWith("image/") && f.size <= 5 * 1024 * 1024) dt.items.add(f);
  });
  input.files = dt.files;                                     // el form queda listo
});
input.addEventListener("change", () => input.form.requestSubmit());
  • Sin preventDefault() en dragover, el navegador ABRE el archivo en lugar de soltarlo — bug número uno de toda zona de drop.
  • Filtramos peso/tipo AL MOMENTO de aceptar el drop: UX honesta.

Preview instantáneo sin servidor

input.addEventListener("change", () => {
  preview.innerHTML = "";
  for (const f of input.files) {
    if (!f.type.startsWith("image/")) continue;
    const url = URL.createObjectURL(f);       // referencia LOCAL al File
    const img = new Image(120, 90);
    img.src = url;
    img.onload = () => URL.revokeObjectURL(url);   // liberar memoria al cargar
    preview.append(img);
  }
});

createObjectURL crea un enlace local al archivo SIN subir nada: la vista previa es instantánea y gratis. revokeObjectURL evita fugas de memoria.

El límite de peso LO PONE EL SERVIDOR

Directiva php.iniControla…Regla práctica
upload_max_filesizepeso máximo POR archivotu tope real por archivo
post_max_sizeTODO el POST (archivos + campos)≥ suma esperada; si te pasas, $_POST y $_Files llegan VACÍOS
max_file_uploadsarchivos simultáneos por requestdefault 20; cuenta los name[]
memory_limitmemoria del scriptsolo importa si procesas imágenes en memoria

Síntomas clásicos: «$_FILES vacío» = post_max_size reventado; «error=1» = superaste upload_max_filesize; «error=2» = superaste el MAX_FILE_SIZE del formulario (campo oculto que PHP respeta).

Estrategia profesional en tres capas

  1. HTML (UX): accept correcto, hint de tamaño en el label, validación JS amable antes de gastar la subida del usuario.
  2. Cliente JS (cortesía): f.size y f.type filtrados en change/drop. Nunca como ÚNICO control.
  3. Servidor (seguridad): revisa error, size, tipo REAL del contenido (finfo/mime_content_type — un .exe renombrado a .jpg declara image/jpeg), renombra el archivo, guarda FUERA del raíz público o con nombre aleatorio.

Practica

BásicoMuestra una vista previa de la imagen elegida en un input file, sin enviarla al servidor, y libera la memoria cuando la vista previa ya cargó.

Ver solución 1
<label for="foto">Elige una foto</label>
<input type="file" id="foto" accept="image/*">
<div id="vista"></div>

<script>
  const input = document.getElementById('foto');
  input.addEventListener('change', () => {
    const archivo = input.files[0];
    if (!archivo) return;
    const img = document.createElement('img');
    img.alt = `Vista previa de ${archivo.name}`;
    img.width = 240;
    img.src = URL.createObjectURL(archivo);
    img.onload = () => URL.revokeObjectURL(img.src);   // liberar la memoria
    document.getElementById('vista').replaceChildren(img);
  });
</script>

createObjectURL crea una URL temporal hacia el archivo local; revokeObjectURL la libera cuando ya no hace falta.

RetoCrea una zona donde se puedan soltar archivos arrastrados y lista el nombre y el tamaño en KB de cada uno. Recuerda qué evento debe cancelar su comportamiento por defecto para que el soltado funcione.

Ver solución 2
<div id="zona" class="zona-drop">Suelta aquí tus fotos</div>
<ul id="lista"></ul>

<script>
  const zona = document.getElementById('zona');
  zona.addEventListener('dragover', (e) => e.preventDefault());   // sin esto, el drop no ocurre
  zona.addEventListener('drop', (e) => {
    e.preventDefault();                                          // evita que el navegador abra el archivo
    const lista = document.getElementById('lista');
    for (const archivo of e.dataTransfer.files) {
      const li = document.createElement('li');
      li.textContent = `${archivo.name} · ${(archivo.size / 1024).toFixed(1)} KB`;
      lista.append(li);
    }
  });
</script>

El tamaño que ves aquí es solo informativo: el límite real lo ponen upload_max_filesize y post_max_size en el servidor, que además debe revisar el contenido real del archivo.

Puntos clave

  • dragover con preventDefault o el drop muere.
  • createObjectURL/revoke: previews gratis y limpias.
  • upload_max_filesize y post_max_size mandan; errores 1/2/3/4 tienen significado.
  • El MIME declarado se finge fácil: valida contenido real en servidor.

18 · Formularios accesibles y con buena UX

Intermedio ~13 min

La diferencia entre un formulario que la gente ABANDONA y uno que completa: etiquetas honestas, errores visibles y foco que no se pierde.

Las cinco reglas de oro

  1. Todo campo con label visible — placeholder NO es label: desaparece al escribir, suele ser gris de bajo contraste y el lector de pantalla lo anuncia como «ejemplo», no como nombre.
  2. Errores junto al campo, en texto (no solo color), con el foco movido al primero.
  3. Grupos nombrados: fieldset+legend para radios/checkboxes relacionados; los lectores anuncian la legend con cada opción.
  4. autocomplete correcto: autollenado fiable = formularios más cortos.
  5. Orden natural: el tabulado sigue el orden del DOM — si tu CSS reordena visualmente, prueba navegar SOLO con Tab.

Errores que sí ayudan: aria-invalid + aria-describedby

<label for="ruc">RUC</label>
<input id="ruc" name="ruc" inputmode="numeric"
       pattern="(10|20)[0-9]{9}"
       aria-describedby="ruc-ayuda ruc-error"
       aria-invalid="true">

<p id="ruc-ayuda" class="small text-secondary">11 dígitos, inicia en 10 o 20.</p>
<p id="ruc-error" class="small text-danger fw-bold">
  El RUC debe tener exactamente 11 dígitos.
</p>
  • aria-describedby enlaza ayuda y error al campo: NVDA los lee juntos.
  • aria-invalid="true" se pone por JS al fallar y SE QUITA al corregir.
  • Error en rojo + icono + texto: nunca SOLO color (daltonismo, impresión).
// mover el foco al primer campo invalido tras validar:
form.addEventListener("submit", (e) => {
  if (!form.checkValidity()) {
    e.preventDefault();
    const malo = form.querySelector(":invalid");
    malo.focus();                      // teclado listo para corregir
    malo.scrollIntoView({ block: "center" });
  }
});

UX que reduce abandono

PrácticaImpacto real
Una columna, campos visibles sin scroll rarocompletado más rápido en móvil
required mínimo indispensablecada campo opcional = menos fricción
Deshabilitar submit UNA vez enviado + texto «Enviando…»mata el doble-pedido clásico
Repoblar valores tras error de servidor (value=)nadie reescribe 10 campos por un RUC malo
Botón con verbo concreto («Registrar pedido»)«Enviar» genérico genera desconfianza

Cuando conviene novalidate

<form novalidate>

Apaga los globales nativos del navegador para usar TU UI de errores consistente (como la del cap. 34 de js_01). La validación nativa sigue disponible vía checkValidity()/reportValidity() — novalidate solo cambia QUIÉN muestra.

Checklist final de formulario profesional

  • Cada input tiene label-for amarrado y name pensado para PHP.
  • Tipos correctos + pattern donde aplique + title explicativo.
  • fieldset para grupos; autocomplete/inputmode en cada campo personal.
  • Errores descritos con aria-describedby, foco al primero, texto además de color.
  • Servidor revalida TODO — el cliente solo adelanta el feedback.

Practica

BásicoMarca un campo de correo que ya tiene un error: el campo debe anunciar que es inválido y leer, en una sola voz, su ayuda («Te enviaremos la boleta») y su mensaje de error.

Ver solución 1
<label for="correo">Correo</label>
<input type="email" id="correo" name="correo" value="percy@" aria-invalid="true"
       aria-describedby="correo-ayuda correo-error">
<p id="correo-ayuda">Te enviaremos la boleta a este correo.</p>
<p id="correo-error">Falta el dominio: escribe algo como percy@correo.pe.</p>

aria-describedby acepta varios id separados por espacio: el lector de pantalla los lee en ese orden después de la etiqueta.

RetoToma el control de la validación: desactiva los globos nativos y, al enviar, marca con aria-invalid los campos inválidos, lleva el foco al primero y, si todo está bien, bloquea el botón para evitar el doble envío.

Ver solución 2
<form id="pedido" action="/pedidos" method="post" novalidate>
  <label for="nombre">Nombre</label>
  <input type="text" id="nombre" name="nombre" required>
  <label for="celular">Celular</label>
  <input type="tel" id="celular" name="celular" required pattern="9\d{8}">
  <button type="submit">Confirmar pedido</button>
</form>

<script>
  const form = document.getElementById('pedido');
  form.addEventListener('submit', (e) => {
    const campos = [...form.elements].filter((el) => el.willValidate);
    campos.forEach((el) => el.setAttribute('aria-invalid', String(!el.checkValidity())));
    const primero = campos.find((el) => !el.checkValidity());
    if (primero) {
      e.preventDefault();
      primero.focus();
      return;
    }
    form.querySelector('button[type="submit"]').disabled = true;
  });
</script>

novalidate apaga solo los globos: las reglas declarativas siguen vivas y checkValidity() las consulta.

Puntos clave

  • Placeholder jamás reemplaza label visible.
  • aria-describedby une campo, ayuda y error en una sola voz.
  • Foco al primer error: el usuario sabe dónde actuar.
  • Repoblar + botones con verbo + anti doble-submit.

19 · Audio y video nativos

Intermedio ~12 min

La etiqueta que mató a Flash: multimedia con controles propios, subtítulos y políticas de reproducción serias.

<video src="tueste.webm" controls
       width="960" height="540"
       poster="tueste-portada.webp"
       preload="metadata">
  <track kind="captions" src="tueste-es.vtt" srclang="es" label="Espanol" default>
  Tu navegador no soporta video nativo.
</video>

Los atributos que gobiernan

AtributoFunciónCuándo
controlsmuestra la barra nativa (play, volumen, pantalla completa)SIEMPRE en video visible — un video sin controles es una trampa
posterimagen de portada ANTES de cargarsiempre: evita primer frame negro
preload"none" | "metadata" | "auto""metadata" es el default sensato; "auto" solo si SABES que lo verán
muted + autoplayarranque automático PERMITIDO solo silenciadovideos de fondo decorativos (y con loop)
loop / playsinlinerepetir / no abrir fullscreen en iOSfondos animados: muted+loop+playsinline juntos
Política de autoplay: los navegadores BLOQUEAN el sonido sin gesto del usuario. autoplay solo funciona acompañado de muted (o tras interacción). Diseña pensando en eso, no contra ello.

source múltiple: formatos en cascada

<video controls width="960" height="540">
  <source src="tueste.webm" type="video/webm">
  <source src="tueste.mp4"  type="video/mp4">
  El navegador toma el PRIMERO que soporte. mp4 (H.264) como ultimo = universal.
</video>

<audio controls preload="metadata">
  <source src="entrevista.ogg" type="audio/ogg">
  <source src="entrevista.mp3" type="audio/mpeg">
</audio>

Subtítulos con track + WebVTT

<track kind="captions" src="subtitulos/es.vtt" srclang="es" label="Espanol" default>
<track kind="subtitles" src="subtitulos/en.vtt" srclang="en" label="English">
# formato WebVTT: marca de tiempo flecha texto
$ cat tueste-es.vtt
WEBVTT

00:00.000 --> 00:04.200
Granos verdes entrando al tambor.

00:04.201 --> 00:08.900
El primer crujido llega cerca de 196 grados.
  • Son ACCESIBILIDAD y SEO a la vez: Google indexa tus transcripciones.
  • kind="captions" incluye efectos sonoros; "subtitles" solo diálogo.

Video propio vs YouTube embed

Criterio<video> propioYouTube/Vimeo embed
Control total (sin logos ni anuncios)síno
Costo de ancho de bandatuyo (¡los videos pesan!)del servicio
Peso en tu páginalo que cargues (lazy/poster)~1–2 MB de su JS (usa fachada, cap. 9)
Descubrimientotu SEOmotor del platform

Practica

BásicoInserta el video tueste en WebM y MP4, con controles, imagen de portada, precarga solo de metadatos y subtítulos en español desde tueste.es.vtt.

Ver solución 1
<video controls preload="metadata" poster="img/tueste-portada.webp" width="640" height="360">
  <source src="video/tueste.webm" type="video/webm">
  <source src="video/tueste.mp4" type="video/mp4">
  <track kind="subtitles" src="video/tueste.es.vtt" srclang="es" label="Español" default>
  Tu navegador no reproduce video. <a href="video/tueste.mp4">Descárgalo aquí</a>.
</video>

El navegador usa el primer source que sabe reproducir: pon primero el formato más liviano.

RetoCrea un video decorativo de fondo que se reproduzca solo, en bucle y también dentro de la página en iPhone, y un audio del podcast «Historias del café» con controles.

Ver solución 2
<video autoplay muted loop playsinline aria-hidden="true" width="1280" height="720">
  <source src="video/finca.webm" type="video/webm">
</video>

<audio controls preload="none">
  <source src="audio/historias-cafe-01.mp3" type="audio/mpeg">
  Tu navegador no reproduce audio.
</audio>

Los navegadores solo permiten autoplay si el video va muted. playsinline evita que iOS lo abra a pantalla completa.

Puntos clave

  • controls siempre; poster siempre; preload metadata.
  • autoplay exige muted (política de los navegadores).
  • track/WebVTT: accesibilidad + SEO indexable.
  • Fondos decorativos: muted + loop + playsinline.

20 · Imágenes responsivas

Intermedio ~13 min

La misma foto servida a un iPhone SE y a un monitor 4K NO debería pesar lo mismo. Aquí se corrige eso.

srcset/sizes: resolución automática

<img
  src="taza-800.webp"
  srcset="taza-400.webp 400w,
          taza-800.webp 800w,
          taza-1600.webp 1600w"
  sizes="(max-width: 600px) 100vw, 50vw"
  alt="Taza de cafe con metodo V60"
  width="1600" height="1067">
AtributoQué dice…
srcset«tengo estas variantes y sus anchos reales EN PIXELES»
sizes«esta imagen ocupará ~X del viewport según el breakpoint»
srcfallback para navegadores prehistóricos (y bots sin srcset)

Con ambos datos, EL NAVEGADOR elige el archivo óptimo considerando ancho de pantalla Y densidad de píxeles (DPR). Tú declaras; él decide. Un móvil 390px con DPR=3 descarga ~1170w efectivos — no el 1600 completo.

picture: cambiar la IMAGEN misma (art direction)

<picture>
  <source type="image/avif" srcset="hero.avif">
  <source type="image/webp" srcset="hero.webp">
  <img src="hero.jpg" alt="Barista latte-art en barra"
       width="1920" height="1080">
</picture>

<!-- encuadres distintos por dispositivo -->
<picture>
  <source media="(max-width: 600px)" srcset="hero-celular-crop.webp">
  <img src="hero-wide.webp" alt="Mostrador de la cafeteria"
       width="1600" height="900">
</picture>
NecesidadHerramienta
Misma imagen, pesos distintossrcset/sizes solos
Formatos nuevos con fallback (AVIF/WebP)picture + source type
Encuadre/recorte distinto en móvilpicture + source media

Las dos leyes del peso

  1. Lazy para todo lo que esté bajo el pliegue: loading="lazy" (visto en cap. 5) combinado con srcset funciona igual.
  2. Hero NUNCA lazy — hero con prioridad: fetchpriority="high" le grita al navegador «descarga ESTA primero» y mejora tu LCP medido (Core Web Vitals).
<img src="hero-1200.webp" fetchpriority="high"
     alt="..." width="1200" height="675">
Flujo de trabajo honesto: genera las variantes con una sola orden (npx sharp-cli resize …, cwebp, o el pipeline de tu bundler) y nombra por ancho: taza-400.webp. Escribir srcset a mano es fácil; producir archivos gigantes «porque sí» es lo caro.

Practica

BásicoLa foto del producto existe en 400, 800 y 1200 px de ancho. Ocupa todo el ancho en celular y unos 600 px desde los 768 px de pantalla. Declara las variantes y el diseño para que el navegador elija.

Ver solución 1
<img src="img/geisha-800.webp"
     srcset="img/geisha-400.webp 400w, img/geisha-800.webp 800w, img/geisha-1200.webp 1200w"
     sizes="(min-width: 768px) 600px, 100vw"
     alt="Bolsa de café Geisha de Cusco de 250 g"
     width="800" height="800" loading="lazy">

Con srcset declaras qué archivos hay; con sizes, cuánto mide la imagen en pantalla. El navegador cruza ambos datos con la densidad de la pantalla.

RetoPara el banner principal: ofrece AVIF y WebP con respaldo JPG, usa un recorte vertical distinto en pantallas de hasta 600 px y dale prioridad de descarga porque está arriba del pliegue.

Ver solución 2
<picture>
  <source media="(max-width: 600px)" srcset="img/banner-vertical.avif" type="image/avif">
  <source media="(max-width: 600px)" srcset="img/banner-vertical.webp" type="image/webp">
  <source srcset="img/banner.avif" type="image/avif">
  <source srcset="img/banner.webp" type="image/webp">
  <img src="img/banner.jpg" alt="Cosecha de café en una finca de Chanchamayo"
       width="1600" height="600" fetchpriority="high">
</picture>

picture siempre termina en un img: es el que se muestra y el que lleva alt. La imagen principal NO lleva loading="lazy".

Puntos clave

  • srcset+w declara variantes; sizes declara layout; navegador decide.
  • picture para formatos y art direction; img hijo SIEMPRE.
  • lazy abajo del pliegue; hero con fetchpriority high.
  • Ancho real en px de cada variante: datos, no suposiciones.

21 · SVG inline

Intermedio ~11 min

Vectores dentro del HTML: nitidez infinita, peso mínimo y colores que obedecen a tu CSS.

Tres formas de usar un SVG

FormaVentajaLimitación
<img src="icono.svg">cacheable como imagenCSS/JS externos NO lo alcanzan (no cambia color)
inline en el HTMLel CSS de la página lo pinta; animableno se cachea aparte; ensucia el markup si abusas
sprite + <use>un solo archivo con todos los iconosrequiere estructura id por símbolo

Inline: el icono que hereda color

<svg width="24" height="24" viewBox="0 0 24 24"
     fill="none" stroke="currentColor" stroke-width="2"
     role="img" aria-hidden="true" focusable="false">
  <path d="M6 6 L18 18 M6 18 L18 6"/>   <!-- una X: cerrar -->
</svg>
  • currentColor: el trazo toma el color del TEXTO padre — modo claro/oscuro gratis (la clave tut-theme ya alterna color y el SVG obedece).
  • viewBox define el lienzo lógico: escala a cualquier size sin perder nada.
  • aria-hidden="true" cuando el icono es DECORATIVO junto a texto visible; si va SOLO, usa role="img" + <title> descriptivo.
  • focusable="false" evita stops fantasma de Tab en IE antiguo — hábito sano.

Sprite: todos los iconos, una descarga

<svg style="display:none">             <!-- libreria invisible -->
  <symbol id="ic-carrito" viewBox="0 0 24 24">
    <path d="M3 3h2l2.6 12.4A2 2 0 0 0 9.6 17H19"/>
  </symbol>
  <symbol id="ic-estrella" viewBox="0 0 24 24">
    <path d="M12 2l3 7h7l-5.5 4.5L18.5 21 12 16.8 5.5 21l2-7.5L2 9h7z"/>
  </symbol>
</svg>

<svg class="ico" aria-hidden="true"><use href="#ic-carrito"/></svg>
<svg class="ico" aria-hidden="true"><use href="#ic-estrella"/></svg>

SVG vs img vs fuente de iconos

NecesidadGanadorPor qué
Iconos UI que cambian de colorSVG inline/spritecurrentColor + cero peticiones
Ilustración compleja estáticaimg svgcacheable, markup limpio
Fotos / imágenes ricasWebP/AVIF (cap. 20)SVG NO sirve para fotos: explota en peso
Miles de iconos con ligadurasfuentes de iconosválido, pero menos accesible y más frágil

SVG interactivo: hover por pieza

<svg viewBox="0 0 100 60" class="plano">
  <style>
    .mesa { fill:#eee; cursor:pointer; }
    .mesa:hover { fill:#f16529; }
  </style>
  <a href="/reserva?mesa=4">
    <rect class="mesa" x="10" y="10" width="20" height="14" rx="3"/>
  </a>
  <text x="15" y="45" font-size="7">Mesa 4</text>
</svg>
Seguridad: SVG es XML con JS posible dentro. Si permites uploads de .svg a tu sitio (cap. 16–17), sanitiza o sírvelo desde otro origen — un SVG malicioso puede ejecutar script al abrirse.

Practica

BásicoCrea un botón «Agregar al carrito» con un icono SVG inline que tome el color del texto y que el lector de pantalla ignore.

Ver solución 1
<button type="button">
  <svg width="16" height="16" viewBox="0 0 16 16" fill="currentColor" aria-hidden="true">
    <path d="M0 1h3l2 9h8l2-6H5" stroke="currentColor" fill="none" stroke-width="1.5"/>
    <circle cx="6" cy="13" r="1.5"/>
    <circle cx="12" cy="13" r="1.5"/>
  </svg>
  Agregar al carrito
</button>

Con currentColor el icono cambia de color junto con el texto (hover, modo oscuro). El texto visible ya nombra el botón: por eso el icono es decorativo.

RetoArma un sprite con dos iconos (i-taza e i-grano) definidos una sola vez y reutilízalos dos veces.

Ver solución 2
<svg style="display: none">
  <symbol id="i-taza" viewBox="0 0 16 16">
    <path d="M2 4h9v5a4 4 0 0 1-4 4H6a4 4 0 0 1-4-4z"/>
  </symbol>
  <symbol id="i-grano" viewBox="0 0 16 16">
    <ellipse cx="8" cy="8" rx="5" ry="7"/>
  </symbol>
</svg>

<p><svg width="20" height="20" aria-hidden="true"><use href="#i-taza"/></svg> Cafetería</p>
<p><svg width="20" height="20" aria-hidden="true"><use href="#i-grano"/></svg> Café en grano</p>

El sprite se oculta con display: none (el atributo hidden no es válido en svg). Cada symbol se dibuja solo cuando un use lo invoca; el sprite completo se escribe (o descarga) una sola vez.

Puntos clave

  • Inline cuando necesitas control; img cuando necesitas cache.
  • currentColor + aria-hidden: iconos decorativos perfectos.
  • Sprites = una petición para toda la librería.
  • Fotos nunca en SVG; uploads de SVG siempre sanitizados.

22 · Canvas: primer vistazo

Intermedio ~12 min

Un lienzo vacío donde JavaScript dibuja píxeles: gráficos, juegos y visualización de datos — y cuándo NO usarlo.

<canvas id="grafico" width="600" height="300"
        role="img" aria-label="Ventas semanales: maximo viernes S/ 4200">
  Tu navegador no soporta canvas.
</canvas>
  • Los atributos width/height definen la RESOLUCIÓN interna del bitmap (¡no el tamaño visual! ese lo da CSS como en cualquier img).
  • El contenido del canvas es INVISIBLE para lectores de pantalla: aria-label con el resumen de los datos no es opcional.

El contexto 2D: tu API de dibujo

const cv = document.getElementById("grafico");
const ctx = cv.getContext("2d");       // TODO pasa por ctx

// fondo
ctx.fillStyle = "#faf7f2";
ctx.fillRect(0, 0, cv.width, cv.height);

// barras de ventas
const ventas = [2600, 3100, 2900, 3400, 4200];
ventas.forEach((v, i) => {
  const alto = v / 4200 * 240;         // escalar a 240px utiles
  ctx.fillStyle = i === 4 ? "#b23117" : "#f16529";
  ctx.fillRect(40 + i * 110, 280 - alto, 80, alto);

  ctx.fillStyle = "#333";
  ctx.font = "13px sans-serif";
  ctx.fillText(`S/ ${v}`, 40 + i * 110, 275 - alto);
});

Modelo mental opuesto a SVG: canvas es «pintar encima» — lo dibujado deja de ser un elemento; para «mover» algo hay que BORRAR todo y repintar. SVG conserva objetos editables e indexables.

Animación básica: el bucle

function cuadro(t) {
  ctx.clearRect(0, 0, cv.width, cv.height);   // borrar TODO
  actualizarFisica();
  dibujarTodo();                              // repintar TODO
  requestAnimationFrame(cuadro);              // eco cap. 39 js_01: rAF, no setInterval
}
requestAnimationFrame(cuadro);

¿Canvas, SVG, video o DOM?

CasoElegirRazón
Gráfico estático/simpleSVG o CSSaccesible, escalable, inspeccionable
Dashboards con miles de puntoscanvaspíxeles baratos: DOM moriría con 10k nodos
Juegos 2D / efectoscanvasredibujo completo a 60fps sin costo DOM
Video realvideocodec nativo, controles, subtítulos
Gráficos de negocio seriosbiblioteca sobre canvas/SVGChart.js/D3 resuelven ejes, tooltips, leyendas
Puente al curso JS: el bucle rAF, el event loop y el profiling del cap. 39 de js_01 son EXACTAMENTE las herramientas para diagnosticar un canvas lento (frames caídos se ven rojos en Performance panel). Canvas amplifica tu JS, no lo reemplaza.

Practica

BásicoDibuja en un canvas de 300 × 150 una barra café de 200 px de ancho con el texto «Ventas de julio» encima. Hazlo accesible.

Ver solución 1
<canvas id="grafico" width="300" height="150" role="img"
        aria-label="Barra de ventas de julio: 200 kilos"></canvas>

<script>
  const ctx = document.getElementById('grafico').getContext('2d');
  ctx.fillStyle = '#6f4e37';
  ctx.fillRect(20, 60, 200, 40);
  ctx.fillStyle = '#222';
  ctx.font = '16px system-ui';
  ctx.fillText('Ventas de julio', 20, 45);
</script>

El canvas es un mapa de bits: para el lector de pantalla no tiene contenido, por eso necesita role="img" y aria-label.

RetoAnima un grano (círculo) que cruce el canvas de izquierda a derecha y vuelva a empezar, usando el bucle correcto para animaciones.

Ver solución 2
<canvas id="anim" width="300" height="100" role="img" aria-label="Grano de café cruzando la pantalla"></canvas>

<script>
  const lienzo = document.getElementById('anim');
  const ctx = lienzo.getContext('2d');
  let x = 0;
  function cuadro() {
    ctx.clearRect(0, 0, lienzo.width, lienzo.height);   // borrar el cuadro anterior
    ctx.beginPath();
    ctx.arc(x, 50, 12, 0, Math.PI * 2);
    ctx.fillStyle = '#6f4e37';
    ctx.fill();
    x = (x + 2) % lienzo.width;
    requestAnimationFrame(cuadro);
  }
  requestAnimationFrame(cuadro);
</script>

En canvas no se «mueve» nada: se borra y se repinta. requestAnimationFrame sincroniza el dibujo con la pantalla y se pausa solo cuando la pestaña no está visible.

Puntos clave

  • width/height = resolución del bitmap; aria-label obligatorio.
  • ctx 2D: pintar encima; mover = clearRect + repintar.
  • rAF para el bucle; miles de nodos → canvas gana.
  • Para gráficos de negocio: biblioteca probada primero.

23 · El head bien hecho

Intermedio ~13 min

Lo invisible que decide cómo te ven Google, WhatsApp, el móvil y la pestaña del navegador.

<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">

  <title>Café de origen peruano · Aroma &amp; Punto</title>
  <meta name="description" content="Tostamos cafés de Chanchamayo y
    Cajamarca. Envíos a todo el Perú en 48 horas.">

  <link rel="icon" href="/favicon.svg" type="image/svg+xml">
  <link rel="canonical" href="https://aromaypunto.pe/">

  <!-- como se ve tu link compartido -->
  <meta property="og:title" content="Aroma &amp; Punto — Café de origen">
  <meta property="og:description" content="Tostado fresco, de chacra a taza.">
  <meta property="og:image" content="https://aromaypunto.pe/og-cafe.webp">
  <meta name="twitter:card" content="summary_large_image">
</head>

title: la media frase más valiosa de tu sitio

  • Fórmula probada: Contenido · Marca (50–60 caracteres: lo que Google muestra sin cortar).
  • ÚNICO por página: «Inicio | Aroma», «Catálogo | Aroma», no todos iguales.
  • Las palabras iniciales pesan más: contenido primero, marca después.

description: tu anuncio gratis en resultados

Google no la usa para rankear directamente, pero SÍ la muestra como resumen cuando es relevante: 150–160 caracteres con verbo y propuesta («Envíos a todo el Perú en 48 horas» convierte más que «Bienvenidos a nuestro sitio»).

Favicons modernos: uno basta

<link rel="icon" href="/favicon.svg" type="image/svg+xml">
<link rel="apple-touch-icon" href="/apple-touch-icon.png">  <!-- 180x180 para iOS -->

Un SVG escala solo; el PNG touch-icon cubre iOS. La era de 6 archivos favicon.ico quedó atrás.

Open Graph: tu tarjeta al compartir

MetaControla…
og:title / og:descriptiontítulo y texto de la tarjeta en WhatsApp/Facebook/Slack
og:imagela miniatura — ABSOLUTA (https://…), ideal 1200×630
og:url + canonicalla dirección «oficial» ante duplicados (con y sin www, con query strings)

Sin og:image, compartir tu producto en WhatsApp sale gris y anónimo. Con ella, parece tienda seria. Es la mejora más barata de CTR que existe.

Otros head útiles (y los que ya NO)

<meta name="theme-color" content="#b23117">   <!-- barra del navegador movil -->
<meta http-equiv="X-UA-Compatible" content="...">   <!-- MUERTO: borrar si lo ves -->
<meta name="keywords" content="...">               <!-- ignorado desde hace anos: fuera -->

Practica

BásicoEscribe el head de la página del café Geisha: título con el contenido primero y la marca después, una descripción persuasiva y la URL canónica https://aromaypunto.pe/cafe/geisha-cusco.

Ver solución 1
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Café Geisha de Cusco 250 g · Aroma y Punto</title>
<meta name="description" content="Geisha de altura con notas a jazmín y durazno. Tostado esta semana y enviado a todo el Perú.">
<link rel="canonical" href="https://aromaypunto.pe/cafe/geisha-cusco">

El title ronda los 50–60 caracteres: lo que no entra se corta en los resultados de Google.

RetoAgrega al mismo head la tarjeta para redes sociales (título, descripción, imagen absoluta de 1200 × 630, URL y tipo) y un favicon SVG.

Ver solución 2
<meta charset="utf-8">
<title>Café Geisha de Cusco 250 g · Aroma y Punto</title>
<link rel="icon" href="/favicon.svg" type="image/svg+xml">
<meta property="og:type" content="product">
<meta property="og:title" content="Café Geisha de Cusco">
<meta property="og:description" content="Notas a jazmín y durazno, tostado esta semana.">
<meta property="og:image" content="https://aromaypunto.pe/img/og/geisha-1200x630.jpg">
<meta property="og:url" content="https://aromaypunto.pe/cafe/geisha-cusco">
<meta name="twitter:card" content="summary_large_image">

og:image debe ser una URL ABSOLUTA: WhatsApp o Facebook no conocen tu carpeta. Con una ruta relativa, el enlace se comparte sin imagen.

Puntos clave

  • title único 50–60 chars: contenido primero, marca después.
  • description = anuncio persuasivo, no lista de palabras.
  • og:image absoluta 1200×630 o tu link se ve muerto.
  • canonical contra duplicados; keywords/X-UA-Compatible fuera.

24 · SEO técnico on-page

Avanzado ~14 min

Todo lo que un crawler premia y puedes controlar SIN backlinks ni presupuesto: estructura, URLs y señales limpias.

La jerarquía que Google entiende

<h1>Café de origen Chanchamayo</h1>      <!-- UN tema por pagina -->
  <h2>Notas de cata</h2>
    <h3>Acidez</h3>
  <h2>Preparación recomendada</h2>

<!-- senales de relevancia natural:
     title = tema oficial
     h1 = desarrollo principal
     h2/h3 = subtemas indexables
     texto de enlaces internos hacia aqui: "cafe chanchamayo", no "clic aqui" -->

URLs limpias y estables

MALBIENPor qué
/prod.php?id=17&ref=x9/cafe/chanchamayolegible por humanos Y crawlers; palabras clave en la URL
/CAFE_Chanchamayo_FINAL2.html/cafe/chanchamayominúsculas, guiones, sin versiones eternas
Cambiar URL cada rediseñoURLs eternas + redirect 301 cuando toquecada URL acumula autoridad; tirarla es regalarla

canonical: una sola verdad ante duplicados

<link rel="canonical" href="https://aromaypunto.pe/cafe/chanchamayo">

Estas tres URLs sirven el mismo producto: ?orden=precio, ?pag=2&color=rojo, con/sin www… canonical le dice a Google cuál INDEXAR — evita diluir tu posicionamiento en copias.

robots: quién entra y qué se indexa

<!-- por pagina: no indexar carritos, gracias, pasos de checkout -->
<meta name="robots" content="noindex, follow">

<!-- public/robots.txt global:
User-agent: *
Allow: /
Disallow: /carrito/
Disallow: /api/

Sitemap: https://aromaypunto.pe/sitemap.xml -->
  • sitemap.xml: inventario de tus URLs reales — ayudas al crawler a no perderse.
  • noindex SOLO en páginas sin valor de búsqueda (formularios enviados, páginas de gracias).

Enlazado interno: tu reparto de autoridad

  • Toda página importante alcanzable en ≤3 clics desde el inicio.
  • Anclas descriptivas entre productos relacionados («compara con el Bourbon de Cajamarca»).
  • Breadcrumbs visibles + marcadas (JSON-LD, cap. 27) — sitelinks bonitos en resultados.

Core Web Vitals: SEO técnico medible

VitalQué mideTu palanca HTML
LCPcuánto tarda el contenido principalhero con fetchpriority high (cap. 20); preload (cap. 26)
CLSsaltos de layoutwidth/height SIEMPRE (cap. 5)
INPrespuesta a interacciónmenos JS bloqueante (defer, cap. 26); dialog/popover nativos (cap. 10)
Puente PHP: URLs amigables tipo /cafe/chanchamayo son exactamente las que el Router PHP que construirás en php_01 (cap. 41) resuelve con regex — y la SPA de js_01 (cap. 41) replica con History API. Misma arquitectura, tres capas.

Practica

BásicoPara la página sobre el café de Chanchamayo, propone una URL limpia y una miga de pan (Inicio › Café › Chanchamayo) bien marcada, y haz que el h1 cuente la misma historia.

Ver solución 1
<!-- URL: https://aromaypunto.pe/cafe/chanchamayo -->
<nav aria-label="Miga de pan">
  <ol>
    <li><a href="/">Inicio</a></li>
    <li><a href="/cafe/">Café</a></li>
    <li><a href="/cafe/chanchamayo" aria-current="page">Chanchamayo</a></li>
  </ol>
</nav>

<h1>Café de Chanchamayo: típica lavada de altura</h1>

La URL va en minúsculas, con guiones y sin fechas ni IDs: así puede vivir para siempre. aria-current="page" marca dónde estás.

RetoEl catálogo también se abre como /cafe/?orden=precio y el carrito (/carrito/) no debe aparecer en Google. Escribe el head de cada página para evitar el contenido duplicado y la indexación del carrito.

Ver solución 2
<!-- En /cafe/?orden=precio (misma lista, otro orden): -->
<meta charset="utf-8">
<title>Café de especialidad · Aroma y Punto</title>
<link rel="canonical" href="https://aromaypunto.pe/cafe/">

<!-- En /carrito/ (página privada de cada visitante): -->
<meta name="robots" content="noindex, follow">

canonical le dice a Google cuál es la versión «oficial»; noindex pide no mostrar la página, pero follow permite seguir sus enlaces.

Puntos clave

  • Un tema por página: title + h1 + URL contando la misma historia.
  • URLs minúsculas-guion-eternas; canonical ante duplicados.
  • Vitals son ranking: LCP/CLS/INP tienen palanca HTML directa.
  • Sitemap + breadcrumbs + enlazado interno ≤3 clics.

25 · Accesibilidad HTML primero

Avanzado ~14 min

El 90% de la accesibilidad sale de usar bien el HTML de este manual. ARIA es el remate, no el fundamento.

La pirámide: semántica > ARIA

Primera regla de ARIA: no uses ARIA si existe un elemento HTML que lo haga solo. Un <button> trae foco, Enter/Espacio y rol anunciado — un div con role="button" y tabindex te obliga a reprogramar TODO eso.

Checklist por pieza del manual

Pieza (cap.)Regla de oro a11y
Encabezados (3)jerarquía sin saltos = índice navegable con tecla H
Imágenes (5)alt informativo o alt="" decorativa — nunca ausente
Landmarks (6)header/nav/main/footer: navegación por regiones (tecla D en NVDA)
Tablas (8)caption + th scope: celdas leídas con contexto
Iframes (9)title descriptivo obligatorio
Nativos (10)details/dialog/popover ya son accesibles — otra razón para no reinventarlos
Formularios (12–18)label-for, fieldset/legend, aria-describedby para errores

Foco visible: nunca lo mates

<!-- MAL: outline none sin reemplazo = navegar a ciegas -->
<a href="/catalogo" style="outline:none">Catálogo</a>

<!-- BIEN: foco personalizado pero SIEMPRE visible -->
<a href="/catalogo" class="enlace">Catálogo</a>
.enlace:focus-visible {
  outline: 3px solid #b23117;
  outline-offset: 2px;
}

Contraste y tamaño objetivo

  • Texto normal ≥ 4.5:1 contra su fondo; texto grande ≥ 3:1 (WCAG AA).
  • Grises sobre blancos «elegantes» suelen fallar — mide con DevTools (el color picker muestra el ratio) o Lighthouse.
  • Áreas táctiles ≈ 44×44 px mínimo: los links de 14px apretados castigan móviles.

ARIA donde sí hace falta

<!-- navs multiples se distinguen con label -->
<nav aria-label="Principal">...</nav>
<nav aria-label="Migas de pan">...</nav>

<!-- estado vivo para zonas que cambian solas -->
<p aria-live="polite" id="aviso"></p>

<!-- expandir/contraer hecho a mano SOLO si details no aplica -->
<button aria-expanded="false" aria-controls="menu-movil">Menú</button>

Prueba rápida de 60 segundos (hazla HOY en tu proyecto)

  1. Desconecta el mouse: ¿puedes operar TODO con Tab/Enter/Espacio?
  2. Activa NVDA (gratis) 30 segundos: ¿los landmarks y labels tienen sentido?
  3. Lighthouse → Accessibility: corre y corrige los rojos.

Practica

BásicoEscribe el CSS que muestre un contorno visible de 3 px al navegar con teclado (sin que aparezca al hacer clic con el mouse) y que asegure botones de al menos 44 px de alto.

Ver solución 1
button:focus-visible,
a:focus-visible,
input:focus-visible {
  outline: 3px solid #b23117;
  outline-offset: 2px;
}

button {
  min-height: 44px;
}

Nunca uses outline: none sin reemplazo: quien navega con teclado se queda sin saber dónde está.

RetoAgrega un enlace «Saltar al contenido» como primer elemento de la página y un aviso que el lector de pantalla anuncie al agregar un producto al carrito, sin mover el foco.

Ver solución 2
<a href="#contenido" class="saltar">Saltar al contenido</a>
<header><p>Aroma y Punto</p></header>

<main id="contenido">
  <h1>Café Geisha de Cusco</h1>
  <button type="button" id="agregar">Agregar al carrito</button>
  <p id="aviso" aria-live="polite"></p>
</main>

<script>
  document.getElementById('agregar').addEventListener('click', () => {
    document.getElementById('aviso').textContent = 'Café Geisha agregado al carrito.';
  });
</script>

Una región aria-live="polite" se anuncia sola cuando cambia su texto, al terminar lo que se esté leyendo. El contenedor debe existir ANTES del cambio.

Puntos clave

  • Semántica correcta > ARIA parche.
  • :focus-visible para estilizar SIN matar el foco.
  • Contraste 4.5:1 y targets de ~44px.
  • aria-live para avisos dinámicos; labels en navs múltiples.

26 · Rendimiento desde el markup

Avanzado ~13 min

Antes de tocar JS o servidor: los atributos y ordenes de carga que HTML pone a tu alcance.

defer vs async: el gráfico mental

<script src="analitica.js" async></script>
<script src="app.js" defer></script>
AtributoDescargaEjecutaÚsalo para…
(nada)bloquea el parseoinmediato al llegarnada, en 2026
asyncparalelaen cuanto llegue (orden NO garantizado)scripts independientes: analítica, widgets
deferparalelatras parsear DOM, en ordenTU app: necesita todo el árbol listo

Regla de la casa: defer por defecto; async solo cuando el script no toca tu DOM. Los módulos ESM ya son defer por naturaleza (<script type="module">).

preload y preconnect: adelantar la cola

<!-- conexion temprana a dominios criticos (fuentes, API) -->
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>

<!-- descarga YA el recurso que LCP necesita y CSS descubrira tarde -->
<link rel="preload" as="image" href="hero-1200.webp" fetchpriority="high">
<link rel="preload" as="font" href="/fuentes/inter.woff2" type="font/woff2"
      crossorigin>
  • preconnect: ahorra el handshake TLS (~100–300 ms) del primer recurso cruzado.
  • preload con moderación: adelantar 5 recursos es atrasar todos — solo lo crítico (hero, fuente principal).
  • El combo hero: preload + fetchpriority high = LCP feliz (cap. 20 y 24).

lazy loading nativo generalizado

<img src="galeria/12.webp" loading="lazy" width="800" height="600" alt="...">
<iframe src="https://maps.google..." loading="lazy" title="Mapa"></iframe>

CSS crítico inline + el resto diferido

<head>
  <style>/* SOLO estilos above-the-fold: ~10-15 KB */</style>
  <link rel="stylesheet" href="/css/completo.css" media="print"
        onload="this.media='all'">
</head>

El truco media="print"+onload carga el CSS completo sin bloquear el primer render. Úsalo con criterio: primero mide si tu CSS bloquea.

Presupuesto de rendimiento (budget)

MétricaObjetivo móvil 4G
Peso total primera carga≤ 500 KB
LCP≤ 2.5 s
Fuentes custom≤ 2 familias, woff2 subset
Scripts bloqueantes0

Practica

BásicoOptimiza el head: conexión anticipada a https://fonts.gstatic.com, precarga de la imagen principal img/banner.webp, el script propio sin bloquear y la analítica independiente.

Ver solución 1
<meta charset="utf-8">
<title>Aroma y Punto</title>
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link rel="preload" href="img/banner.webp" as="image" fetchpriority="high">
<script src="js/app.js" defer></script>
<script src="https://analitica.ejemplo.pe/tag.js" async></script>

defer respeta el orden y espera al HTML: es el valor por defecto sensato. async se ejecuta apenas llega, sin orden: solo para scripts que no dependen de nadie.

RetoPon en línea el CSS crítico de la cabecera (fondo y color del header) y carga css/resto.css sin bloquear el primer dibujo, con respaldo para quien no tiene JavaScript.

Ver solución 2
<meta charset="utf-8">
<title>Aroma y Punto</title>
<style>
  header { background: #3b2a20; color: #fff; padding: 1rem; }
</style>
<link rel="stylesheet" href="css/resto.css" media="print" onload="this.media='all'">
<noscript><link rel="stylesheet" href="css/resto.css"></noscript>

Con media="print" el navegador descarga la hoja sin bloquear la pantalla; al cargar, el script la activa para todos los medios.

Puntos clave

  • defer default; async solo para independientes; bloqueante nunca.
  • preconnect para dominios clave; preload solo lo crítico.
  • loading lazy en imágenes/iframes bajo el pliegue.
  • Presupuesto escrito: lo que no se mide, se infla.

27 · Datos estructurados JSON-LD

Avanzado ~12 min

Hablarle a Google en su idioma: datos máquina-legibles que convierten tu resultado en una tarjeta rica.

El formato: JSON-LD en el head

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Café Chanchamayo tostado medio 500g",
  "image": ["https://aromaypunto.pe/img/chanchamayo-800.webp"],
  "description": "Tueste medio, notas de chocolate y naranja.",
  "sku": "CAF-0001",
  "brand": { "@type": "Brand", "name": "Aroma & Punto" },
  "offers": {
    "@type": "Offer",
    "url": "https://aromaypunto.pe/cafe/chanchamayo",
    "priceCurrency": "PEN",
    "price": "28.00",
    "availability": "https://schema.org/InStock"
  }
}
</script>
  • Un bloque JSON-LD describe la página EN DATOS: Google no tiene que adivinar qué número es precio ni qué texto es nombre.
  • Resultado visible: estrellas de reseñas, precio y stock DIRECTO en resultados.

Tipos que más rinden para una tienda

@typeActiva…
Product + Offerprecio/stock en resultados (rich results)
AggregateRatingestrellas de valoración — SOLO con reviews reales en la página
BreadcrumbListmigas de pan visibles bajo el título del resultado
LocalBusinessficha de tienda física: horario, dirección, teléfono
FAQPagepreguntas desplegables en resultados

Breadcrumbs completos

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    { "@type": "ListItem", "position": 1,
      "name": "Inicio", "item": "https://aromaypunto.pe/" },
    { "@type": "ListItem", "position": 2,
      "name": "Café", "item": "https://aromaypunto.pe/cafe" },
    { "@type": "ListItem", "position": 3,
      "name": "Chanchamayo" }
  ]
}

Debe ESPEJAR tus migas visibles (cap. 24): lo marcado y lo mostrado cuentan la misma historia o Google ignora ambos.

Generación dinámica desde PHP/JS

Cuando el catálogo viene de base de datos, este bloque se GENERA: en PHP con json_encode() de un array asociativo; en tu SPA con JSON.stringify(). El markup es el mismo — solo cambia quién arma el objeto. Cruce directo con php_01 cap. 41.

Practica

BásicoEscribe el JSON-LD de tipo Product para el Geisha de Cusco (250 g) a S/ 45.00, disponible en stock. Irá dentro de <script type="application/ld+json">.

Ver solución 1
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Café Geisha de Cusco 250 g",
  "image": "https://aromaypunto.pe/img/geisha-1200.webp",
  "description": "Geisha de altura con notas a jazmín y durazno.",
  "brand": { "@type": "Brand", "name": "Aroma y Punto" },
  "offers": {
    "@type": "Offer",
    "price": "45.00",
    "priceCurrency": "PEN",
    "availability": "https://schema.org/InStock",
    "url": "https://aromaypunto.pe/cafe/geisha-cusco"
  }
}

La moneda va en código ISO 4217 (PEN para soles). Marca solo lo que el usuario ve en la página.

RetoEscribe el BreadcrumbList de la miga Inicio › Café › Geisha de Cusco, ya dentro de su etiqueta script.

Ver solución 2
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    { "@type": "ListItem", "position": 1, "name": "Inicio", "item": "https://aromaypunto.pe/" },
    { "@type": "ListItem", "position": 2, "name": "Café", "item": "https://aromaypunto.pe/cafe/" },
    { "@type": "ListItem", "position": 3, "name": "Geisha de Cusco" }
  ]
}
</script>

El último elemento es la página actual: puede ir sin item. Comprueba el resultado en la prueba de resultados enriquecidos de Google.

Puntos clave

  • JSON-LD en script type application/ld+json: datos, no apariencia.
  • Product+Offer/Breadcrumb son los de mayor retorno para tiendas.
  • Solo marcar lo visible; validar en Rich Results Test.
  • Se genera dinámicamente cuando el contenido vive en BD.

28 · Internacionalización

Avanzado ~12 min

Preparar el markup para varios idiomas y formatos — empezando por hacerlo bien en español peruano.

lang: la base de todo

<html lang="es">

<!-- fragmento en otro idioma dentro de la pagina -->
<p>Nuestro lema: <q lang="en">From bean to cup</q>.</p>
  • Los lectores de pantalla cambian de voz según lang — sin él, pronuncian tu español con acento inglés robótico.
  • Google segmenta por idioma declarado; los correctores ortográficos también lo usan.
  • Código compuesto regional si aplica: es-PE, pt-BR.

Sitio multilingüe: hreflang

<!-- en cada version, apuntar a TODAS las alternativas incluida la propia -->
<link rel="alternate" hreflang="es-PE" href="https://aromaypunto.pe/cafe/chanchamayo">
<link rel="alternate" hreflang="en"     href="https://aromaypunto.pe/en/coffee/chanchamayo">
<link rel="alternate" hreflang="x-default" href="https://aromaypunto.pe/cafe/chanchamayo">
PiezaFunción
hreflang«esta página existe TAMBIÉN en estos idiomas» — Google muestra la correcta al usuario correcto
x-defaultla versión para idiomas no listados o usuarios sin preferencia
URLs propias por idioma/en/… separadas (NO traducir con JS en vivo): cada versión indexable

dir: idiomas de derecha a izquierda

<html lang="ar" dir="rtl">   <!-- pagina arabe completa -->
<p dir="rtl" lang="he">...</p>  <!-- solo un parrafo hebreo -->

Formatos locales: HTML marca, no formatea

<time datetime="2026-08-23T15:30-05:00">domingo, 23 de agosto, 3:30 p.m.</time>
<data value="PEN">S/ 28.00</data>
  • El atributo datetime lleva formato MÁQUINA ISO; el texto visible es humano. Lo mejor de ambos mundos para buscadores y calendarios.
  • Fechas/números/moneda los FORMATEA tu backend o JS Intl (new Intl.NumberFormat("es-PE", {style:"currency", currency:"PEN"})) — el markup solo los envuelve con significado.

Contenido que no se traduce igual: checklist PE

  • Moneda explícita siempre: «S/ 28.00» o «PEN 28.00», nunca «28».
  • Teléfonos con código país en tel:: +51987654321.
  • Direcciones: formato local visible + estructura address semántica:
<address>
  Aroma &amp; Punto<br>
  Av. Arequipa 1234, Lince<br>
  Lima, Perú
</address>

Practica

BásicoEn una página en español, marca la frase en inglés «Good coffee takes time», una fecha de entrega legible para personas y máquinas, y el precio con un valor que un programa pueda leer.

Ver solución 1
<p>Como dicen los baristas: <q lang="en">Good coffee takes time</q>.</p>
<p>Entrega: <time datetime="2026-07-15">miércoles 15 de julio</time>.</p>
<p>Precio: <data value="45.00">S/ 45.00</data></p>

El lang del fragmento hace que el lector de pantalla cambie de voz. HTML no formatea: marca el dato ISO adentro y deja el formato humano afuera.

RetoLa tienda tiene versión en español de Perú (/es/) y en inglés (/en/). Escribe los enlaces hreflang del head, incluida la versión por defecto.

Ver solución 2
<meta charset="utf-8">
<title>Aroma y Punto</title>
<link rel="alternate" hreflang="es-PE" href="https://aromaypunto.pe/es/">
<link rel="alternate" hreflang="en" href="https://aromaypunto.pe/en/">
<link rel="alternate" hreflang="x-default" href="https://aromaypunto.pe/es/">

Cada versión debe listar TODAS las demás y a sí misma. x-default indica qué mostrar cuando ningún idioma coincide.

Puntos clave

  • lang en html y en fragmentos extranjeros: voz correcta + SEO.
  • Multilingüe real = URLs separadas + hreflang completo.
  • datetime/data: máquina ISO adentro, humano afuera.
  • Moneda y teléfonos nunca ambiguos (S/, +51).

29 · Web Components: primer vistazo

Intermedio ~13 min

El estándar que te deja inventar tus propias etiquetas HTML — sin framework.

<tarjeta-precio moneda="PEN" precio="28">
  Café Chanchamayo 500g
</tarjeta-precio>

Las tres piezas del estándar

PiezaQué resuelve
<template>markup inerte que clonas con JS: se parsea pero NO se renderiza ni ejecuta hasta usarlo
Custom Elementsregistrar tu etiqueta con comportamiento propio (customElements.define)
Shadow DOMDOM privado: los estilos de afuera NO entran, los de adentro NO salen

Componente mínimo completo

<template id="tpl-precio">
  <style>
    :host { display:inline-block; padding:.25rem .6rem;
            background:#b23117; color:#fff; border-radius:.4rem; }
  </style>
  <span><slot></slot> — <b class="p"></b></span>
</template>

<script type="module">
  const tpl = document.getElementById("tpl-precio");

  class TarjetaPrecio extends HTMLElement {
    connectedCallback() {
      this.attachShadow({ mode: "open" })
          .appendChild(tpl.content.cloneNode(true));
      this.shadowRoot.querySelector(".p").textContent =
        `${this.getAttribute("moneda")} ${this.getAttribute("precio")}`;
    }
  }
  customElements.define("tarjeta-precio", TarjetaPrecio);
</script>
  • :host: el componente mismo, estilizado desde DENTRO del shadow DOM.
  • <slot>: la ventana por donde entra el contenido del usuario («Café Chanchamayo 500g» cae ahí).
  • El guion en tarjeta-precio es OBLIGATORIO: las etiquetas custom deben llevar «-» para no chocar jamás con futuras etiquetas nativas.

¿Cuándo SÍ y cuándo NO?

EscenarioElegir
Widget reutilizable en sitios con stacks distintos (web corporativa, design systems)Web Component: cero dependencias, corre en todas partes
App completa con estado, rutas, datosframework (Vue/React): te dan reactividad y ecosistema
Botón o tarjeta simple de una páginaHTML+CSS normal: un componente es over-engineering
Puente: la SPA que harás en js_01 (cap. 41) renderiza «componentes» con funciones y strings; los Web Components son la versión ESTANDARIZADA de esa idea. Cuando llegues a Vue/React reconocerás props, slots y ciclo de vida — ya los viste aquí.

Practica

BásicoCrea el componente <sello-origen> que muestre, con estilo propio encapsulado, el texto que reciba entre sus etiquetas.

Ver solución 1
<sello-origen>Chanchamayo</sello-origen>

<script>
  customElements.define('sello-origen', class extends HTMLElement {
    constructor() {
      super();
      this.attachShadow({ mode: 'open' }).innerHTML = `
        <style>
          :host { display: inline-block; padding: .2rem .6rem; border-radius: 1rem;
                  background: #6f4e37; color: #fff; font-size: .85rem; }
        </style>
        <slot></slot>`;
    }
  });
</script>

El nombre lleva guion obligatorio; :host estiliza al propio componente y slot muestra el contenido de afuera.

RetoCrea <tarjeta-cafe> a partir de un template, con dos ranuras con nombre: nombre y precio. Úsalo dos veces.

Ver solución 2
<template id="tpl-tarjeta">
  <style>
    :host { display: block; border: 1px solid #ccc; border-radius: .5rem; padding: 1rem; }
    .precio { font-weight: bold; }
  </style>
  <h3><slot name="nombre">Sin nombre</slot></h3>
  <p class="precio"><slot name="precio"></slot></p>
</template>

<tarjeta-cafe>
  <span slot="nombre">Geisha de Cusco</span>
  <span slot="precio">S/ 45.00</span>
</tarjeta-cafe>
<tarjeta-cafe>
  <span slot="nombre">Bourbon de Cajamarca</span>
  <span slot="precio">S/ 32.00</span>
</tarjeta-cafe>

<script>
  customElements.define('tarjeta-cafe', class extends HTMLElement {
    constructor() {
      super();
      const tpl = document.getElementById('tpl-tarjeta');
      this.attachShadow({ mode: 'open' }).append(tpl.content.cloneNode(true));
    }
  });
</script>

El template no se dibuja: es un molde. Cada instancia clona su contenido; el texto dentro del slot es el valor por defecto.

Puntos clave

  • template + customElements.define + shadow DOM = etiqueta propia.
  • Nombre SIEMPRE con guion; slot recibe contenido; :host se autostila.
  • Ideal para widgets portables; apps grandes → framework.

30 · PWA: manifiesto e instalable

Intermedio ~13 min

Que tu sitio se instale en el celular como app: icono, nombre, pantalla propia — con dos archivos HTML.

manifest.json: la ficha de tu app

{
  "name": "Aroma & Punto",
  "short_name": "AromaP",
  "start_url": "/",
  "display": "standalone",
  "background_color": "#faf7f2",
  "theme_color": "#b23117",
  "icons": [
    { "src": "/icono-192.png", "sizes": "192x192", "type": "image/png" },
    { "src": "/icono-512.png", "sizes": "512x512", "type": "image/png" }
  ]
}
<link rel="manifest" href="/manifest.json">
<meta name="theme-color" content="#b23117">
  • standalone: abre SIN barra de navegador — apariencia de app nativa.
  • Los dos tamaños de icono son el mínimo que Android exige para instalar.
  • theme_color pinta la barra de estado del sistema (el mismo meta del cap. 23).

Service worker: el mayordomo de red

<script>
  if ("serviceWorker" in navigator) {
    navigator.serviceWorker.register("/sw.js");
  }
</script>
// sw.js — vive en la raiz para controlar TODO el sitio
const CACHE = "aroma-v1";
const ESENCIALES = ["/", "/css/completo.css", "/img/chanchamayo-800.webp"];

self.addEventListener("install", e => {
  e.waitUntil(caches.open(CACHE)
    .then(c => c.addAll(ESENCIALES)));
});

self.addEventListener("fetch", e => {
  e.respondWith(
    caches.match(e.request)
      .then(hit => hit || fetch(e.request))
  );
});
  • Es un JS que vive ENTRE tu página y la red: puede servir del caché sin conexión.
  • Estrategia mínima «cache primero»: instantáneo para lo esencial; lo demás va a red.
  • Cambias algo? Sube el nombre de caché (aroma-v2) — el viejo se descarta.

Checklist instalable (Chrome/Android)

RequisitoDónde
manifest con name, icons 192+512, start_url, displaycap. actual
service worker registrado con fetch handlercap. actual
Servido por HTTPSrequisito duro: sin TLS no hay SW

Cumplido esto, Chrome ofrece «Instalar app» solo. iOS lo agrega desde Compartir → Añadir a inicio (usa apple-touch-icon del cap. 23).

Offline UX: avisar en lugar de fallar

window.addEventListener("offline", () =>
  document.body.insertAdjacentHTML("afterbegin",
    `<div class="alert alert-warning m-0 text-center">Sin conexión: mostrando datos guardados</div>`)
);
window.addEventListener("online", () =>
  document.querySelector(".alert-warning")?.remove()
);

Practica

BásicoEscribe el manifest.json de «Aroma y Punto»: nombre largo y corto, URL de inicio, modo independiente, colores y dos iconos (192 y 512 px).

Ver solución 1
{
  "name": "Aroma y Punto · Café de origen",
  "short_name": "Aroma y Punto",
  "start_url": "/",
  "display": "standalone",
  "background_color": "#ffffff",
  "theme_color": "#6f4e37",
  "icons": [
    { "src": "/img/icono-192.png", "sizes": "192x192", "type": "image/png" },
    { "src": "/img/icono-512.png", "sizes": "512x512", "type": "image/png" }
  ]
}

Se enlaza desde el head con <link rel="manifest" href="/manifest.json">. Sin HTTPS no hay instalación.

RetoEscribe el sw.js que guarde en caché la portada, el CSS y el logo al instalarse, responda primero desde la caché y borre las cachés de versiones anteriores al activarse.

Ver solución 2
const VERSION = 'aroma-v2';
const ESENCIALES = ['/', '/css/estilos.css', '/img/logo.svg'];

self.addEventListener('install', (e) => {
  e.waitUntil(caches.open(VERSION).then((cache) => cache.addAll(ESENCIALES)));
});

self.addEventListener('activate', (e) => {
  e.waitUntil(
    caches.keys().then((nombres) =>
      Promise.all(nombres.filter((n) => n !== VERSION).map((n) => caches.delete(n))))
  );
});

self.addEventListener('fetch', (e) => {
  e.respondWith(caches.match(e.request).then((guardado) => guardado || fetch(e.request)));
});

Cambiar VERSION al publicar cambios es lo que obliga a renovar la caché. Se registra desde la página con navigator.serviceWorker.register('/sw.js').

Puntos clave

  • manifest + SW + HTTPS = instalable; dos archivos bastan.
  • Cache primero para esenciales; versiona el nombre al cambiar.
  • Eventos online/offline para UX honesta sin conexión.

31 · Las APIs del navegador

Intermedio ~12 min

El navegador trae superpoderes de fábrica: ubicación, portapapeles, cámara y más — todos piden permiso primero.

Mapa rápido del arsenal

APIPara quéPermiso
navigator.clipboardcopiar/pegar programáticosolo para leer
IntersectionObserver«¿este elemento ya es visible?» sin scroll listenersno
localStorage / sessionStoragepersistencia clave-valor localno
geolocationubicación del usuarioSÍ, explícito
getUserMediacámara/micrófonoSÍ, explícito
Notificationnotificaciones del sistemaSÍ, explícito

Copiar al portapapeles (el clásico de cupones)

<p>Cupón: <output id="cupon">CAFEVERANO15</output></p>
<button id="btn-copiar" class="btn btn-outline-primary btn-sm">
  Copiar cupón
</button>
document.getElementById("btn-copiar").addEventListener("click", async () => {
  const cupon = document.getElementById("cupon").textContent;
  await navigator.clipboard.writeText(cupon);
  const btn = document.getElementById("btn-copiar");
  btn.textContent = "¡Copiado!";
  setTimeout(() => btn.textContent = "Copiar cupón", 2000);
});

IntersectionObserver: lazy real y animaciones al entrar

// revelar secciones cuando entran al viewport
const obs = new IntersectionObserver(entradas => {
  entradas.forEach(e => {
    if (e.isIntersecting) {
      e.target.classList.add("visible");
      obs.unobserve(e.target);        // una sola vez
    }
  });
}, { threshold: 0.15 });

document.querySelectorAll(".revelable").forEach(el => obs.observe(el));

Geolocalización con manejo honesto de errores

const opciones = { enableHighAccuracy: false, timeout: 8000 };

navigator.geolocation.getCurrentPosition(pos => {
  console.log(`Lat ${pos.coords.latitude}, Lng ${pos.coords.longitude}`);
}, err => {
  // el usuario dijo NO, o tardo demasiado: NUNCA asumir que saldra bien
  aviso.textContent = "No pudimos obtener tu ubicacion: usaremos la ciudad principal.";
}, opciones);
  • El permiso SIEMPRE es del usuario: diseña el flujo «sin ubicación» antes de pedirlo.
  • Pide geolocalización SOLO en contexto (botón «sucursales cerca»), nunca al cargar la página.

Detección de capacidades: feature detection

if ("clipboard" in navigator) {
  mostrarBotonCopiar();
} else {
  mostrarCuponSeleccionable();   // plan B, no error
}

Practica

BásicoAgrega un botón que copie el cupón CAFE10 al portapapeles y avise si se copió o no.

Ver solución 1
<p>Tu cupón: <strong id="cupon">CAFE10</strong></p>
<button type="button" id="copiar">Copiar cupón</button>
<p id="mensaje" aria-live="polite"></p>

<script>
  document.getElementById('copiar').addEventListener('click', async () => {
    const mensaje = document.getElementById('mensaje');
    try {
      await navigator.clipboard.writeText(document.getElementById('cupon').textContent);
      mensaje.textContent = 'Cupón copiado.';
    } catch {
      mensaje.textContent = 'No se pudo copiar: selecciónalo y usa Ctrl+C.';
    }
  });
</script>

El portapapeles exige HTTPS y una acción del usuario (un clic). Diseña siempre el camino del «no».

RetoHaz que las tarjetas con la clase revelar reciban la clase visible cuando entren en pantalla, una sola vez, y que en navegadores sin IntersectionObserver se muestren todas de inmediato.

Ver solución 2
<article class="revelar"><h2>Geisha de Cusco</h2></article>
<article class="revelar"><h2>Bourbon de Cajamarca</h2></article>

<script>
  const tarjetas = document.querySelectorAll('.revelar');
  if ('IntersectionObserver' in window) {
    const observador = new IntersectionObserver((entradas) => {
      for (const entrada of entradas) {
        if (entrada.isIntersecting) {
          entrada.target.classList.add('visible');
          observador.unobserve(entrada.target);    // una sola vez
        }
      }
    });
    tarjetas.forEach((t) => observador.observe(t));
  } else {
    tarjetas.forEach((t) => t.classList.add('visible'));   // plan B
  }
</script>

Detección de capacidades: preguntas si la API existe, nunca qué navegador es. El plan B deja el contenido visible.

Puntos clave

  • Cada API poderosa cuesta un permiso: diseño primero el «no».
  • IntersectionObserver reemplaza scroll listeners caros.
  • Feature detection con plan B; user-agent jamás.

32 · Proyecto integrador y cierre

Meta ~45 min

Una página completa de producto que usa lo aprendido en los 31 capítulos — tu plantilla de despegue para todo proyecto web.

El encargo

Página de producto «Café Chanchamayo» para Aroma & Punto, con: ficha del producto con precio y botón de compra, formulario de suscripción validado, reseñas, mapa embebido y datos estructurados. Un solo archivo HTML (más CSS/JS externos si prefieres) servido localmente.

Esqueleto obligatorio

<!DOCTYPE html>
<html lang="es-PE">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">

  <title>Café Chanchamayo tostado medio 500g · Aroma &amp; Punto</title>   <!-- cap23 -->
  <meta name="description" content="Tueste medio con notas de chocolate...">
  <link rel="canonical" href="https://aromaypunto.pe/cafe/chanchamayo">
  <meta property="og:image" content="https://aromaypunto.pe/img/chanchamayo-og.webp">

  <link rel="preload" as="image" href="chanchamayo-800.webp"
        fetchpriority="high">                                     <!-- cap26 -->
</head>
<body>
  <header><nav aria-label="Principal">...</nav></header>          <!-- caps6/25 -->

  <main>
    <article>
      <picture>...webp + jpg fallback, sizes...</picture>          <!-- cap20 -->
      <h1>Café Chanchamayo</h1>
      <p>Notas de cata: <em>chocolate</em>, naranja, panela.</p>

      <svg aria-hidden="true">...sprite estrella x4.8...</svg>      <!-- cap21 -->
      <time datetime="2026-08-23">reseñas de agosto</time>          <!-- cap28 -->

      <form novalidate>                                            <!-- caps12-18 -->
        <label for="correo">Correo para cupones</label>
        <input id="correo" name="correo" type="email"
               required autocomplete="email"
               pattern="[a-z0-9._%+-]+@[a-z0-9.-]+\.[a-z]{2,}$">
        <p id="err-correo" aria-live="polite"></p>
        <button type="submit" class="btn btn-primary">Suscribirme</button>
      </form>

      <iframe loading="lazy" title="Mapa tienda Lince"...></iframe>  <!-- cap9 -->
    </article>
  </main>

  <footer><address>Av. Arequipa 1234, Lince — Lima</address></footer>

  <script type="application/ld+json">{ "@type": "Product", ... }</script>  <!-- cap27 -->
  <script src="/js/app.js" defer></script>                          <!-- cap26 -->
</body>
</html>

Lista de verificación final (imprímela)

ÁreaDebe cumplirse…Cap.
Estructuralandmarks completos, un solo h1, jerarquía sin saltos3, 6
Imágenesformato moderno + fallback, width/height SIEMPRE, alt correcto5, 20
Formulariolabel-for, validación nativa+JS, errores con aria-live12–18, 25
SEOtitle único, OG completo, canonical, JSON-LD validado23, 24, 27
Rendimientohero precargado, resto lazy, defer en scripts, budget ≤500 KB26
A11yprueba de teclado de 60 s sin quedarte trabado25

Rúbrica de autoevaluación

  • Lighthouse ≥ 90 en las cuatro categorías (Performance, Accessibility, Best Practices, SEO).
  • Navegable al 100% con teclado; NVDA lee la ficha sin ruidos.
  • Rich Results Test acepta tu JSON-LD.
  • Sin una sola imagen sin dimensiones (CLS = 0).
Cierre: dominas el lenguaje sobre el que TODO lo demás se construye: tu PHP genera este markup, tu JS lo anima, los frameworks lo abstraen. Siguiente parada natural: Vue (cap. 42 js_01) o el manual de HTML avanzado/CSS cuando lo publiques. El navegador ya es tuyo.

Practica

BásicoArma el esqueleto completo de la ficha de producto: head con lo esencial, cabecera con menú, producto con foto y precio, formulario «Agregar al carrito» con cantidad, y pie de página.

Ver solución 1
<!DOCTYPE html>
<html lang="es">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Café Geisha de Cusco 250 g · Aroma y Punto</title>
  <meta name="description" content="Geisha de altura con notas a jazmín y durazno.">
  <link rel="canonical" href="https://aromaypunto.pe/cafe/geisha-cusco">
  <link rel="stylesheet" href="/css/estilos.css">
  <script src="/js/app.js" defer></script>
</head>
<body>
  <a href="#contenido">Saltar al contenido</a>
  <header>
    <p>Aroma y Punto</p>
    <nav aria-label="Principal">
      <ul>
        <li><a href="/">Inicio</a></li>
        <li><a href="/cafe/">Café</a></li>
      </ul>
    </nav>
  </header>

  <main id="contenido">
    <article>
      <h1>Café Geisha de Cusco 250 g</h1>
      <img src="/img/geisha-800.webp" alt="Bolsa de café Geisha de Cusco de 250 g"
           width="800" height="800" fetchpriority="high">
      <p>Precio: <data value="45.00">S/ 45.00</data></p>
      <form action="/carrito" method="post">
        <label for="cantidad">Cantidad</label>
        <input type="number" id="cantidad" name="cantidad" min="1" max="10" value="1">
        <button type="submit">Agregar al carrito</button>
      </form>
    </article>
  </main>

  <footer>
    <p>© 2026 Aroma y Punto · <a href="tel:+51987654321">+51 987 654 321</a></p>
  </footer>
</body>
</html>

Revisa que cada pieza venga de un capítulo: head (2 y 23), landmarks (6), imagen (5 y 20), formulario (12 a 15) y accesibilidad (25).

RetoAudita tu proyecto como lo haría un equipo profesional: sírvelo en local, pásalo por el validador oficial y por Lighthouse, y corrige hasta tener 0 errores de validación y 90 o más en Accesibilidad y SEO.

Ver solución 2
# 1. Servir el proyecto (capítulo 2)
npx serve .

# 2. Validar el HTML: pega la URL o sube el archivo en
#    https://validator.w3.org/nu/

# 3. Auditar rendimiento, accesibilidad, buenas prácticas y SEO
npx lighthouse http://localhost:3000 --view

Corrige primero los errores del validador: muchos avisos de Lighthouse desaparecen solos cuando el HTML es correcto.