W3docs

Tag HTML <html>

Il tag <html> definisce un documento scritto in HyperText Markup Language e contiene tutti gli elementi fondamentali di un documento HTML.

Il tag <html> è l'elemento radice di un documento HTML — si trova in cima all'albero del documento e racchiude ogni altro elemento della pagina. "Radice" significa che non ha alcun elemento genitore: quando il browser analizza la pagina e la trasforma nel DOM (Document Object Model, l'albero di nodi che costruisce in memoria), l'elemento <html> è il singolo nodo da cui discendono tutti gli altri. Poiché tutto risiede al suo interno, il tag <html> è anche il posto dove si impostano attributi validi per l'intera pagina, come la lingua del documento e la direzione del testo.

L'unica cosa che può apparire prima di <html> è la dichiarazione <!DOCTYPE>, che indica al browser quale versione di HTML utilizza il documento e lo commuta in modalità standard.

L'elemento <html> ha esattamente due figli diretti, che devono comparire in quest'ordine:

  • Il tag <head>, che contiene i metadati per il browser e i motori di ricerca — i tag <title>, <link>, <script> e simili. Nulla all'interno di <head> viene mostrato direttamente sulla pagina.
  • Il tag <body>, che contiene tutto ciò che il visitatore vede effettivamente: testo, immagini, link e così via.
Suggerimento

Imposta sempre l'attributo lang su <html>. Indica al browser, ai motori di ricerca e alle tecnologie assistive in quale lingua è scritto il documento. Questo migliora l'indicizzazione, aiuta i browser a scegliere i font e la resa corretti per i caratteri nazionali, e consente agli screen reader di selezionare la pronuncia e la voce appropriate.

Tag HTML <html> con l'attributo "lang"

<html lang="en">

L'attributo lang

Il valore di lang è un tag di lingua BCP 47 — un codice breve e standardizzato per una lingua umana. La forma più comune è un sottotag di lingua a due lettere (da ISO 639), seguito facoltativamente da un sottotag di regione o script separato da un trattino.

<html lang="en">          <!-- English -->
<html lang="en-US">       <!-- English, United States -->
<html lang="fr">          <!-- French -->
<html lang="de">          <!-- German -->
<html lang="zh-Hans">     <!-- Chinese, Simplified script -->
<html lang="zh-Hant">     <!-- Chinese, Traditional script -->
<html lang="ar">          <!-- Arabic -->

Imposta lang una sola volta su <html> per dichiarare la lingua principale del documento. Se una sezione della pagina è in una lingua diversa, puoi sovrascriverla su qualsiasi elemento interno (ad esempio <p lang="fr">).

L'attributo dir

L'attributo dir imposta la direzione del testo di base del documento. È essenziale per le lingue che si leggono da destra a sinistra, come l'arabo e l'ebraico.

ValoreSignificato
ltrDa sinistra a destra (impostazione predefinita; usato per inglese, francese, ecc.)
rtlDa destra a sinistra (usato per arabo, ebraico, persiano)
autoLascia che il browser decida in base al contenuto
<html lang="ar" dir="rtl">

Impostare dir="rtl" su <html> inverte l'allineamento predefinito della pagina in modo che testo, barre di scorrimento e molte funzionalità di layout si rispecchino correttamente per i sistemi di scrittura da destra a sinistra.

Sintassi

Il tag <html> si usa in coppia. Tutto il contenuto della pagina è scritto tra il tag di apertura <html> e il tag di chiusura </html>.

In HTML5 il tag di chiusura </html> è tecnicamente opzionale — il parser può dedurre la fine del documento. Tuttavia, dovresti sempre includerlo. Un </html> esplicito mantiene chiara la struttura del documento, evita sorprese quando la pagina viene elaborata dagli strumenti e diventa obbligatorio se la pagina viene servita come XHTML.

Esempio del tag HTML <html>:

Tag HTML <html>

<!DOCTYPE html>
<html lang="en">
   <head>
      <title>Title of the document</title>
   </head>
   <body>
      The content of the page
   </body>
</html>

Modifica l'esempio precedente nell'editor ed eseguilo per vedere il risultato nel tuo browser.

"Provalo tu stesso" non è disponibile per questo esempio.

Attributi

AttributoValoreDescrizione
langTag di lingua BCP 47Dichiara la lingua principale del documento (ad esempio en, fr, zh-Hans). Consigliato su ogni pagina per accessibilità e SEO.
dirltr / rtl / autoImposta la direzione di base del testo. Usa rtl per le lingue da destra a sinistra come l'arabo e l'ebraico.
idtextAssegna un identificatore univoco all'elemento, utilizzato principalmente come aggancio per CSS o scripting.
xmlnshttps://www.w3.org/1999/xhtmlNamespace XML per il documento. Richiesto solo per XHTML; ignorato quando la pagina viene servita come text/html, quindi non è necessario in HTML5.
manifestURLPuntava a un manifest della cache dell'app per la visualizzazione offline. Obsoleto — rimosso dallo standard; usa invece i service worker.

Gli attributi lang, dir e id sopra elencati sono quelli più comunemente usati, e <html> accetta anche l'intero insieme degli Attributi Globali e degli Attributi Evento Globali.

Esercitazione

Pratica
Qual è il ruolo dell'elemento HTML html?
Qual è il ruolo dell'elemento HTML html?
Was this page helpful?