HTMLper Svogliati
Lo usano tutti, non lo studia nessuno. Si impara copiando pezzi da altre pagine, e così il web si è riempito di <div> che fanno finta di essere bottoni, titoli scelti per la grandezza del carattere e immagini senza descrizione. L'HTML scritto bene è più corto, funziona senza JavaScript, si legge con lo screen reader e piace ai motori di ricerca. E costa meno fatica di quello scritto male.
"Il bottone non funziona con la tastiera." — "Quale bottone?" — "Quel div con onclick."
Cos'è, e soprattutto cosa non è
HTML dice cosa è ogni pezzo della pagina. Non come appare, non cosa fa quando lo clicchi.
Una pagina web è fatta di tre strati, e ognuno ha un mestiere solo. Quasi tutti i pasticci nascono dall'usare uno strato per fare il lavoro di un altro: tabelle per impaginare, JavaScript per fare un link, CSS per scrivere testo.
HTML: cosa è
"Questo è un titolo, questo è un elenco, questo è un link, questo è un campo per l'email." È la struttura, e da sola è già una pagina che funziona.
CSS: come appare
Colori, caratteri, spazi, colonne, adattamento al telefono. Togli il CSS e la pagina deve restare leggibile.
JavaScript: cosa fa
Comportamenti che il browser non ha già: aggiornare dati senza ricaricare, calcoli, interazioni complesse. Non serve per un link o un menu a tendina.
Da un fisico del CERN al "Living Standard"
Trent'anni di guerre tra browser, standard abbandonati e un ritorno al buon senso.
Tim Berners-Lee e i primi tag
Al CERN, per condividere documenti tra ricercatori. Una ventina di tag: titoli, paragrafi, elenchi, e il link, l'idea che ha cambiato tutto. Niente immagini, niente colori.
HTML 2, 3.2 e la guerra dei browser
Netscape e Internet Explorer inventano tag a gara per battere l'altro: <font>, <blink>, <marquee>. Le pagine "funzionano meglio con" un browser solo. L'aspetto si scrive dentro l'HTML, e diventa un disastro da mantenere.
HTML 4 e il CSS
Il W3C separa la struttura dall'aspetto: l'HTML descrive, il CSS disegna. In teoria. In pratica si continua a impaginare con le tabelle per altri dieci anni.
XHTML, il vicolo cieco
Il W3C vuole un HTML rigido come l'XML: un errore e la pagina non si vede. I browser non seguono, il web reale non si adatta. XHTML 2 viene abbandonato. Ne resta l'abitudine di scrivere <br />, oggi inutile ma innocua.
WHATWG e HTML5
I produttori di browser fondano il WHATWG e scrivono lo standard per come il web funziona davvero, errori compresi. Arrivano <video>, <header>, <main>, i nuovi tipi di campo dei form. Nel 2014 HTML5 diventa raccomandazione W3C.
Il Living Standard
W3C e WHATWG smettono di avere due versioni: lo standard è uno, si chiama solo "HTML" e si aggiorna di continuo. Non esiste HTML6. Ogni tanto arriva qualcosa di nuovo e utile, come <dialog> e l'attributo popover, quando tutti i browser lo supportano.
Lo scheletro minimo
Sette righe che ogni pagina deve avere. Ognuna ha un motivo, e quando ne manca una si vede.
<!DOCTYPE html>
<html lang="it">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Configurare WireGuard su Debian</title>
</head>
<body>
<h1>Configurare WireGuard su Debian</h1>
<p>Dieci minuti, due comandi e un file.</p>
</body>
</html>
| Riga | A cosa serve | Se la togli |
|---|---|---|
<!DOCTYPE html> | Dice al browser di usare le regole moderne | Il browser va in "quirks mode": imita i bug di Internet Explorer 5 e il CSS si comporta in modo strano |
lang="it" | La lingua della pagina | Lo screen reader legge l'italiano con la pronuncia inglese; il traduttore automatico sbaglia lingua |
charset="UTF-8" | Come leggere i caratteri | Le lettere accentate diventano è e simili |
viewport | Dice al telefono di usare la sua larghezza vera | Sul telefono la pagina appare come un desktop rimpicciolito, da ingrandire con le dita |
<title> | Il nome nella scheda del browser e nei risultati di ricerca | La scheda mostra l'indirizzo; Google si inventa un titolo |
</p> e </li> finali sono facoltativi, type="text/javascript" e type="text/css" non servono più, la barra in <br /> è inutile. Ma tollerante non vuol dire che indovina sempre: chiudi i tag, ti eviti sorprese.
Il concetto chiave: il tag dice cosa è
Si chiama semantica. Scegli il tag per il significato, mai per come appare: l'aspetto lo decide il CSS.
Scrivi sugli scatoloni "cucina", "libri", "fragile". Non scrivi "scatola marrone grande". Chi scarica il furgone sa dove portarli senza aprirli, e il facchino cieco li sistema lo stesso. I tag HTML sono quelle etichette: il browser, lo screen reader, Google e le IA leggono le etichette, non guardano i colori. Un <div> è uno scatolone senza scritte.
Un div non è un bottone
Un <button> si raggiunge con Tab, si preme con Invio e con lo spazio, viene annunciato come pulsante. Un <div onclick> non fa niente di tutto questo, finché non lo riscrivi a mano.
I titoli sono un indice
Un <h1> per la pagina, <h2> per le sezioni, <h3> dentro le sezioni. Senza saltare livelli. Se vuoi un titolo più piccolo, è CSS, non un <h4>.
Link per andare, bottone per fare
Porta a un'altra pagina o a un punto della pagina? <a href>. Fa qualcosa (invia, apre, chiude, calcola)? <button>. Un link con href="#" e JavaScript è un bottone travestito.
Così
<button type="button">Apri menu</button><a href="/vpn/">Guida VPN</a><h2>con un CSS che lo rimpicciolisce<ul>per qualsiasi elenco, anche il menu
Non così
<div class="btn" onclick="..."><span onclick="location='/vpn/'"><h4>perché "l'h2 era troppo grande"- Righe di
<div>separate da<br>per fare un elenco
La struttura della pagina
Dal 2014 ci sono tag per le zone della pagina. Al posto di <div id="header">, c'è <header>. E lo screen reader ci salta sopra con un tasto.
<body>
<header> <!-- testata: logo, nome del sito -->
<nav> <!-- il menu principale -->
<ul>
<li><a href="/">Home</a></li>
<li><a href="/guide/" aria-current="page">Guide</a></li>
</ul>
</nav>
</header>
<main> <!-- il contenuto vero: uno solo per pagina -->
<article> <!-- un pezzo che sta in piedi da solo -->
<h1>VPN per Svogliati</h1>
<section> <!-- una parte, con il suo titolo -->
<h2>Cos'è una VPN</h2>
<p>...</p>
</section>
</article>
<aside> <!-- contenuto a lato: correlati, note -->
<h2>Leggi anche</h2>
</aside>
</main>
<footer> <!-- piè di pagina: contatti, privacy -->
<p><a href="/privacy/">Privacy</a></p>
</footer>
</body>
| Tag | Quando | Il dubbio classico |
|---|---|---|
<main> | Il contenuto principale, uno per pagina | Non ci vanno testata, menu e piè di pagina |
<article> | Qualcosa che ha senso anche copiato altrove: un post, una scheda prodotto, un commento | Se lo ritagli e lo incolli in un'altra pagina, si capisce ancora? Allora è un article |
<section> | Una parte di un discorso, con un titolo | Senza un titolo dentro, probabilmente era un <div> |
<aside> | Contenuto collegato ma secondario | Se lo togli, il contenuto principale si capisce ancora |
<nav> | Blocchi di navigazione importanti | Non ogni gruppo di link: il menu principale, l'indice, la paginazione |
<div> | Un contenitore senza significato, per il CSS | Va benissimo! Il problema non è il div, è usarlo al posto di un tag che ha un significato |
Testo e link
I tag che usi tutti i giorni, con le differenze che quasi nessuno conosce.
| Tag | Significato | Da non confondere con |
|---|---|---|
<strong> | Importante, da non perdere | <b>: grassetto senza importanza, per esempio una parola chiave in un riassunto |
<em> | Enfasi: cambia il senso della frase ("io non l'ho detto") | <i>: corsivo per convenzione, come un termine straniero o un titolo |
<code>, <pre> | Codice in una riga; blocco di testo preformattato | Per un comando su più righe: <pre><code>...</code></pre> |
<kbd> | Un tasto da premere: Ctrl+C | <code>, che è testo da scrivere |
<blockquote>, <q> | Una citazione lunga o corta | Rientrare il testo per bellezza: è CSS |
<ul>, <ol>, <dl> | Elenco puntato, numerato, di termini con definizione | Righe staccate con <br> |
<time datetime="2026-10-30"> | Una data leggibile anche dalle macchine | Una data scritta solo come testo |
<abbr title="..."> | Un'abbreviazione, con la forma estesa | — |
<!-- il testo del link dice dove porta -->
Leggi la <a href="/vpn/">guida alle VPN</a>. <!-- non "clicca qui" -->
<!-- link a un punto della pagina: l'id dell'elemento -->
<a href="#installazione">Vai all'installazione</a>
<h2 id="installazione">Installazione</h2>
<!-- nuova scheda: solo se serve davvero (chi legge sa usare il tasto centrale) -->
<a href="https://esempio.it" target="_blank" rel="noopener">esempio.it</a>
<!-- email, telefono, file da scaricare -->
<a href="mailto:info@esempio.it">Scrivici</a>
<a href="tel:+390212345678">02 1234 5678</a>
<a href="/listino.pdf" download>Listino (PDF, 300 KB)</a>
target="_blank" senza rel="noopener" permetteva alla pagina aperta di cambiare l'indirizzo della tua. I browser moderni ora lo applicano da soli, ma scriverlo non costa niente. Per i link pagati o affiliati aggiungi rel="sponsored": la guida SEO spiega perché.
Immagini: alt, dimensioni e lazy
Tre attributi che quasi tutti dimenticano. Il primo serve alle persone, il secondo a non far saltare la pagina, il terzo a non scaricare quello che nessuno vedrà.
<img src="/img/rack.webp"
alt="Armadio rack con switch e due mini PC collegati"
width="800" height="600"
loading="lazy">
<!-- immagine decorativa: alt VUOTO, non assente. Lo screen reader la salta -->
<img src="/img/onda.svg" alt="" width="1200" height="80">
<!-- con didascalia -->
<figure>
<img src="/img/grafico.png" alt="Il traffico raddoppia tra marzo e aprile" width="900" height="500">
<figcaption>Traffico mensile, 2026</figcaption>
</figure>
<!-- formati moderni con ripiego -->
<picture>
<source srcset="/img/foto.avif" type="image/avif">
<img src="/img/foto.jpg" alt="..." width="800" height="600">
</picture>
🗣️ alt: cosa scrivere
Quello che diresti al telefono a chi non vede l'immagine, se servisse a capire la pagina. Non "immagine di", non il nome del file, non una lista di parole chiave. Se l'immagine è solo decorazione: alt="".
📐 width e height: perché
Il browser riserva lo spazio prima di scaricare l'immagine, e il testo non salta giù quando arriva. Non fissano la dimensione mostrata: con max-width:100%; height:auto nel CSS l'immagine si adatta lo stesso.
loading="lazy" rimanda lo scaricamento finché l'immagine non sta per entrare nello schermo. Sull'immagine principale, quella che si vede subito, rallenta proprio il caricamento che Google misura. Lazy solo per quello che sta sotto.
Tabelle: solo per i dati
Impaginare con le tabelle è morto nel 2010. Per i dati veri, righe e colonne, la tabella resta la scelta giusta.
<table>
<caption>Consumo a riposo</caption>
<thead>
<tr><th scope="col">Macchina</th><th scope="col">Watt</th></tr>
</thead>
<tbody>
<tr><th scope="row">Mini PC</th><td>8</td></tr>
<tr><th scope="row">Raspberry Pi</th><td>4</td></tr>
</tbody>
</table>
<th> è un'intestazione, <td> un dato: lo screen reader, arrivato su "8", legge "Mini PC, Watt, 8". Con <caption> la tabella ha un titolo vero. Sul telefono, una tabella larga si mette in un contenitore con overflow-x: auto: scorre la tabella, non la pagina.
Form: il browser fa già metà del lavoro
Tastiera giusta sul telefono, controlli di validità, compilazione automatica, messaggi d'errore. Tutto gratis, se usi i tipi e gli attributi giusti.
<form action="/iscriviti" method="post">
<label for="email">Email</label>
<input id="email" name="email" type="email"
autocomplete="email" required>
<label for="anni">Anni di esperienza</label>
<input id="anni" name="anni" type="number" min="0" max="60">
<fieldset>
<legend>Sistema preferito</legend>
<label><input type="radio" name="os" value="debian" checked> Debian</label>
<label><input type="radio" name="os" value="altro"> Altro</label>
</fieldset>
<button type="submit">Iscriviti</button>
</form>
| Cosa scrivi | Cosa ottieni gratis |
|---|---|
<label for="..."> | Cliccando l'etichetta si attiva il campo; lo screen reader legge il nome del campo |
type="email", "tel", "url", "number" | La tastiera giusta sul telefono e un controllo di formato |
type="date", "time", "color" | Un selettore di data, ora o colore del sistema, senza librerie |
required, min, max, pattern, maxlength | Il browser blocca l'invio e mostra un messaggio nella lingua dell'utente |
autocomplete="email", "name", "new-password" | Compilazione automatica e password manager che funzionano |
<datalist> | Suggerimenti mentre scrivi, senza JavaScript |
<button type="button"> | Un bottone che NON invia il form (dentro un form il tipo predefinito è submit) |
Accessibilità: già fatta all'80%
Se hai seguito le sezioni prima, la pagina è già quasi accessibile. Il resto sono poche abitudini.
Chi usa uno screen reader, chi naviga solo con la tastiera, chi ingrandisce il testo al 200%, chi vede male i colori: non sono casi rari, e in più ci sei tu col telefono al sole. L'HTML giusto risolve la maggior parte dei problemi da solo, perché i tag hanno già un ruolo, un comportamento da tastiera e un nome.
Abitudini
- Prova la pagina solo con la tastiera: Tab, Shift+Tab, Invio, spazio. Arrivi a tutto? Vedi sempre dove sei?
- Non togliere il contorno del focus (
outline: none) senza metterne un altro - Un
altsu ogni immagine, unalabelsu ogni campo - Contrasto sufficiente tra testo e sfondo, soprattutto per il testo grigio chiaro
- Non affidare un'informazione solo al colore: "i campi in rosso" non lo vede chi non distingue il rosso
Errori comuni
- Icone-bottone senza testo: aggiungi
aria-label="Chiudi" - Bloccare lo zoom con
user-scalable=no - Link tutti uguali: dieci "Leggi di più" non dicono niente a chi li sente in fila
role="button"su un div invece di usare un button
aria-* servono a spiegare allo screen reader componenti che l'HTML non ha. La prima regola, scritta dagli autori stessi: se esiste un elemento HTML che fa già quella cosa, usa quello. Un ARIA sbagliato è peggio di nessun ARIA, perché annuncia cose che non sono vere.
Per siti di aziende e pubbliche amministrazioni, in Europa l'accessibilità è anche un obbligo di legge (European Accessibility Act). Per tutti gli altri è buon senso: le stesse cose aiutano anche i motori di ricerca e le IA a capire la pagina.
Il head: quello che non si vede
Nessuno lo guarda, ma decide come la pagina appare su Google, su WhatsApp e nella scheda del browser.
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>WireGuard su Debian in dieci minuti</title>
<meta name="description" content="Installazione, chiavi, un client e il firewall.">
<link rel="canonical" href="https://esempio.it/wireguard/">
<!-- anteprima quando condividi il link (WhatsApp, Telegram, social) -->
<meta property="og:title" content="WireGuard su Debian in dieci minuti">
<meta property="og:image" content="https://esempio.it/og.png">
<!-- icona della scheda: un SVG copre quasi tutti i casi -->
<link rel="icon" href="/favicon.svg" type="image/svg+xml">
<link rel="stylesheet" href="/style.css">
<script src="/app.js" defer></script> <!-- defer: non blocca la pagina -->
</head>
| Script | Quando parte | Usalo per |
|---|---|---|
<script src> nel head | Subito, e la pagina aspetta | Quasi mai: blocca la visualizzazione |
defer | Dopo che l'HTML è stato letto, nell'ordine in cui li hai scritti | Il caso normale: i tuoi script |
async | Appena scaricato, in ordine sparso | Script indipendenti, come le statistiche |
type="module" | Come defer, con i moduli JavaScript | Codice moderno con import |
Il resto del discorso su title, description, canonical e dati strutturati è nella guida SEO.
Cose che il browser fa già, senza JavaScript
Prima di installare una libreria per un menu a tendina, guarda se l'HTML non ce l'ha già. Spesso sì.
<!-- una sezione che si apre e si chiude (FAQ, dettagli, spoiler) -->
<details>
<summary>Perché la VPN non si collega?</summary>
<p>Nove volte su dieci è la porta UDP chiusa dal router.</p>
</details>
<!-- un popup che si apre con un bottone: niente script -->
<button popovertarget="info">Info</button>
<div id="info" popover>Si chiude con Esc o cliccando fuori.</div>
<!-- una finestra di dialogo vera: blocca il resto e gestisce il focus -->
<dialog id="conferma">
<form method="dialog">
<p>Cancellare il backup?</p>
<button value="no">Annulla</button> <button value="si">Cancella</button>
</form>
</dialog>
<!-- per aprirlo basta una riga: document.getElementById('conferma').showModal() -->
| Ti serve | HTML che lo fa già |
|---|---|
| Fisarmonica, FAQ, "mostra di più" | <details> e <summary> |
| Popup, menu a comparsa, suggerimenti | Attributo popover con popovertarget |
| Finestra di conferma | <dialog> |
| Selettore di data, ora, colore | <input type="date">, "time", "color" |
| Barra di avanzamento | <progress>, e <meter> per un livello (disco pieno al 70%) |
| Video e audio | <video controls>, <audio controls> |
| Caricare le immagini quando servono | loading="lazy" |
| Controllo dei campi del form | required, pattern, type |
Errori tradotti (il validatore)
Il validatore del W3C dice cosa c'è di sbagliato, in inglese e in modo secco. Ecco cosa intende.
| Cosa dice | Cosa vuol dire | Cosa fare |
|---|---|---|
An img element must have an alt attribute | Immagine senza descrizione | alt="...", o alt="" se è decorativa |
Duplicate ID | Due elementi con lo stesso id | L'id è unico per pagina: per i gruppi si usa class |
Element div not allowed as child of element ul | Dentro un elenco ci vanno solo <li> | Metti il div dentro un li, o togli il div |
Stray end tag div | Un tag chiuso che non era aperto: c'è un </div> di troppo | Conta aperture e chiusure; l'editor con il rientro automatico aiuta |
Unclosed element | Il contrario: un tag aperto e mai chiuso | Cerca dove finisce davvero e chiudilo lì |
The character encoding was not declared | Manca <meta charset="UTF-8"> | Aggiungilo come prima riga del head |
Start tag seen without seeing a doctype first | Manca <!DOCTYPE html> | Prima riga del file, prima di tutto |
Bad value for attribute href | L'indirizzo contiene spazi o caratteri non validi | Spazi come %20, o meglio niente spazi nei nomi dei file |
The element a must not appear as a descendant of the button element | Un link dentro un bottone (o il contrario) | O è un link o è un bottone: sezione 4 |
Heading cannot be a child of another heading | Un titolo dentro un altro titolo | Separali; per un sottotitolo usa un <p> o uno <span> |
Trailing slash on void elements has no effect | Hai scritto <br /> o <img ... /> | Solo un'informazione: non fa danni, puoi ignorarlo |
Tag morti e abitudini da buttare
Li trovi ancora nei template copiati e nelle risposte vecchie dei forum. Alcuni funzionano ancora, nessuno andrebbe usato.
| Vecchio | Al suo posto |
|---|---|
<font>, <center>, bgcolor, align | CSS |
<marquee>, <blink> | Niente. Davvero niente |
<frameset>, <frame> | Pagine vere con un menu comune |
| Tabelle per impaginare | CSS Grid e Flexbox |
<br><br><br> per fare spazio | margin nel CSS |
per rientrare | padding o margin |
<meta name="keywords"> | Niente: i motori lo ignorano da anni |
<a href="javascript:void(0)"> | <button type="button"> |
<object> e <embed> per Flash | Flash è morto nel 2020. <video> per i video |
<meta http-equiv="X-UA-Compatible"> | Serviva a Internet Explorer, che non esiste più |
<font> e <center> si apre ancora oggi. È un pregio del web. Non è un invito a usarli: sono fuori dallo standard, non si combinano bene con il CSS e rendono la pagina impossibile da mantenere.
Cheat sheet
Quale tag per cosa, in una tabella sola. Più gli strumenti per controllare.
| Vuoi | Usa |
|---|---|
| Il titolo della pagina | Un <h1>, poi <h2> e <h3> in ordine |
| Andare da un'altra parte | <a href> |
| Fare un'azione | <button type="button"> |
| Un elenco | <ul> o <ol> con <li> |
| Il contenuto principale | <main>, uno per pagina |
| Il menu | <nav> con un <ul> di link |
| Un'immagine | <img alt width height>, loading="lazy" se sotto la piega |
| Dati in righe e colonne | <table> con <th> e <caption> |
| Un campo del form | <label> + <input type="..."> del tipo giusto |
| Apri e chiudi | <details> e <summary> |
| Un popup | popover o <dialog> |
| Un contenitore per il CSS | <div> (blocco) o <span> (in riga): va benissimo |
# il validatore ufficiale, da browser: incolli l'indirizzo o il codice
# https://validator.w3.org/nu/
# lo stesso validatore in locale (Java), utile su tanti file
java -jar vnu.jar --skip-non-html sito/
# oppure con Node
npx html-validate "sito/**/*.html"