Svogliati
🧱

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."

↓
01 / 15

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.

💡 HTML non è un linguaggio di programmazioneNon ha variabili, cicli o condizioni. È un linguaggio di marcatura: metti delle etichette intorno al testo per dire cosa è. Per questo si impara in un pomeriggio, ed è proprio per questo che nessuno lo studia, e lo scrive male per vent'anni.
02 / 15

Da un fisico del CERN al "Living Standard"

Trent'anni di guerre tra browser, standard abbandonati e un ritorno al buon senso.

1991

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.

1995–1997

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.

1997–1999

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.

2000–2009

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.

2004–2014

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.

2019 → oggi

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.

03 / 15

Lo scheletro minimo

Sette righe che ogni pagina deve avere. Ognuna ha un motivo, e quando ne manca una si vede.

html · la pagina minima corretta
<!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>
RigaA cosa serveSe la togli
<!DOCTYPE html>Dice al browser di usare le regole moderneIl 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 paginaLo screen reader legge l'italiano con la pronuncia inglese; il traduttore automatico sbaglia lingua
charset="UTF-8"Come leggere i caratteriLe lettere accentate diventano è e simili
viewportDice al telefono di usare la sua larghezza veraSul telefono la pagina appare come un desktop rimpicciolito, da ingrandire con le dita
<title>Il nome nella scheda del browser e nei risultati di ricercaLa scheda mostra l'indirizzo; Google si inventa un titolo
✅ Le cose che puoi non scrivereIl browser è molto tollerante: </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.
04 / 15

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.

📦 L'analogia: le etichette del trasloco

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.

REGOLA 1

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.

REGOLA 2

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>.

REGOLA 3

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
05 / 15

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.

html · una pagina tipica
<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>
TagQuandoIl dubbio classico
<main>Il contenuto principale, uno per paginaNon ci vanno testata, menu e piè di pagina
<article>Qualcosa che ha senso anche copiato altrove: un post, una scheda prodotto, un commentoSe lo ritagli e lo incolli in un'altra pagina, si capisce ancora? Allora è un article
<section>Una parte di un discorso, con un titoloSenza un titolo dentro, probabilmente era un <div>
<aside>Contenuto collegato ma secondarioSe lo togli, il contenuto principale si capisce ancora
<nav>Blocchi di navigazione importantiNon ogni gruppo di link: il menu principale, l'indice, la paginazione
<div>Un contenitore senza significato, per il CSSVa benissimo! Il problema non è il div, è usarlo al posto di un tag che ha un significato
06 / 15

Testo e link

I tag che usi tutti i giorni, con le differenze che quasi nessuno conosce.

TagSignificatoDa 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 preformattatoPer 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 cortaRientrare il testo per bellezza: è CSS
<ul>, <ol>, <dl>Elenco puntato, numerato, di termini con definizioneRighe staccate con <br>
<time datetime="2026-10-30">Una data leggibile anche dalle macchineUna data scritta solo come testo
<abbr title="...">Un'abbreviazione, con la forma estesa—
html · link fatti bene
<!-- 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>
🔗 noopener oggiUna volta 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é.
07 / 15

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à.

html · un'immagine fatta bene
<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.

🐢 Mai lazy sull'immagine in cimaloading="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.
08 / 15

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.

html · una tabella leggibile anche dallo screen reader
<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.

09 / 15

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.

html · un form che funziona senza una riga di JavaScript
<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 scriviCosa 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, maxlengthIl 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)
🛑 La validazione del browser non è sicurezzaÈ comodità per chi compila. Chiunque può spedire al server quello che vuole saltando il form. I controlli veri si rifanno sempre anche sul server.
10 / 15

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 alt su ogni immagine, una label su 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
♿ La prima regola di ARIAGli attributi 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.

12 / 15

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ì.

html · apri e chiudi, finestre e popup
<!-- 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 serveHTML che lo fa già
Fisarmonica, FAQ, "mostra di più"<details> e <summary>
Popup, menu a comparsa, suggerimentiAttributo 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 servonoloading="lazy"
Controllo dei campi del formrequired, pattern, type
🪶 Perché convieneQuello che fa il browser funziona con la tastiera, con lo screen reader, sul telefono, senza aggiornamenti di librerie e senza falle di sicurezza in codice altrui. E pesa zero byte.
13 / 15

Errori tradotti (il validatore)

Il validatore del W3C dice cosa c'è di sbagliato, in inglese e in modo secco. Ecco cosa intende.

Cosa diceCosa vuol direCosa fare
An img element must have an alt attributeImmagine senza descrizionealt="...", o alt="" se è decorativa
Duplicate IDDue elementi con lo stesso idL'id è unico per pagina: per i gruppi si usa class
Element div not allowed as child of element ulDentro un elenco ci vanno solo <li>Metti il div dentro un li, o togli il div
Stray end tag divUn tag chiuso che non era aperto: c'è un </div> di troppoConta aperture e chiusure; l'editor con il rientro automatico aiuta
Unclosed elementIl contrario: un tag aperto e mai chiusoCerca dove finisce davvero e chiudilo lì
The character encoding was not declaredManca <meta charset="UTF-8">Aggiungilo come prima riga del head
Start tag seen without seeing a doctype firstManca <!DOCTYPE html>Prima riga del file, prima di tutto
Bad value for attribute hrefL'indirizzo contiene spazi o caratteri non validiSpazi come %20, o meglio niente spazi nei nomi dei file
The element a must not appear as a descendant of the button elementUn link dentro un bottone (o il contrario)O è un link o è un bottone: sezione 4
Heading cannot be a child of another headingUn titolo dentro un altro titoloSeparali; per un sottotitolo usa un <p> o uno <span>
Trailing slash on void elements has no effectHai scritto <br /> o <img ... />Solo un'informazione: non fa danni, puoi ignorarlo
14 / 15

Tag morti e abitudini da buttare

Li trovi ancora nei template copiati e nelle risposte vecchie dei forum. Alcuni funzionano ancora, nessuno andrebbe usato.

VecchioAl suo posto
<font>, <center>, bgcolor, alignCSS
<marquee>, <blink>Niente. Davvero niente
<frameset>, <frame>Pagine vere con un menu comune
Tabelle per impaginareCSS Grid e Flexbox
<br><br><br> per fare spaziomargin nel CSS
&nbsp;&nbsp;&nbsp; per rientrarepadding o margin
<meta name="keywords">Niente: i motori lo ignorano da anni
<a href="javascript:void(0)"><button type="button">
<object> e <embed> per FlashFlash è morto nel 2020. <video> per i video
<meta http-equiv="X-UA-Compatible">Serviva a Internet Explorer, che non esiste più
🧟 Perché funzionano ancoraI browser non rompono mai le pagine vecchie: una pagina del 1997 con <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.
15 / 15

Cheat sheet

Quale tag per cosa, in una tabella sola. Più gli strumenti per controllare.

VuoiUsa
Il titolo della paginaUn <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 popuppopover o <dialog>
Un contenitore per il CSS<div> (blocco) o <span> (in riga): va benissimo
bash · controllare l'HTML
# 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"
🧱 L'ultimo consiglio da svogliatoPrima di aggiungere un div, chiediti se esiste un tag che dice cos'è. Prima di aggiungere JavaScript, chiediti se il browser non lo fa già. Due domande, e la pagina viene più corta, più veloce, accessibile e capita da Google. Senza fatica in più: anzi, con meno.