Vai al contenuto principale
SEO

Semantica e punti di riferimento del documento

I controlli semantici del documento cercano uno schema coerente: un'area di contenuto principale, punti di riferimento sensibili e relazioni tra le sezioni che corrispondono a ciò che vedono gli utenti. I problemi qui spesso si presentano come regioni principali mancanti o duplicate, contenitori generici senza nome che fungono da regioni o ordine delle intestazioni che non riflette la gerarchia visiva.

Le tecnologie assistive utilizzano la struttura semantica del DOM, in particolare punti di riferimento e intestazioni, per costruire una struttura di pagina. Quando il contenuto principale manca, è duplicato o annidato in modo errato, gli utenti non possono passare al "contenuto principale" in modo affidabile.

I controlli automatizzati nel tuo rapporto segnalano modelli concreti (ad esempio più linee principali, punti di riferimento vuoti o salti di rotta). Correggi gli elementi citati, mantieni un elemento principale prevedibile per vista, quindi esegui nuovamente la scansione per confermare che il problema sia stato risolto.

Nel report, usate questo elemento come evidenza. Non trattatelo come regola autonoma a meno che il contesto della pagina non supporti la stessa conclusione.

Come interpretarlo

  • Esattamente un <main> (o un singolo elemento con role="main") racchiude l'argomento principale dell'URL, non l'intero chrome del sito, a meno che la pagina non sia una shell di app completa con struttura documentata.
  • Chrome ripetuto utilizza intestazione, navigazione e piè di pagina; le barre laterali complementari usano side o role="complementary" con un nome quando sono regioni di riferimento.
  • I livelli di intestazione riflettono l'annidamento: un H3 segue un H2 che introduce la sua sezione, non un salto arbitrario da H1 a H4 per la dimensione del carattere.
Punto di riferimentoUtilizzo tipico
principaleContenuti unici principali per questo URL.
navPrincipali blocchi di navigazione (sito o sommario in-page).
intestazione/piè di paginaCollegamenti masthead e meta/footer del sito o della pagina.
accanto/complementareContenuti di supporto relativi all'argomento principale.

Shell di pagina minima

<body>
  <header>… site header …</header>
  <nav aria-label="Primary">…</nav>
  <main>
    <h1>Currency prices</h1>
    … primary content …
  </main>
  <footer>…</footer>
</body>

Errori comuni

  • Avvolgendo l'intera pagina, inclusa la navigazione globale, all'interno di main.
  • Aggiunta di role="banner" o role="navigation" a ogni div per gli hook di stile.
  • Utilizzo dei tag di intestazione solo per la tipografia, il che interrompe la struttura per gli utenti di screen reader.
  • Creazione di punti di riferimento "regionali" personalizzati senza aria-labelledby, aria-label o un riferimento di intestazione visibile.

Riferimenti utili

Domande frequenti

Può esserci più di un elemento principale?

Generalmente no per una visualizzazione di un singolo documento: una principale identifica il contenuto principale. Se incorpori un altro documento (iframe), quel documento nidificato può avere il proprio file main.

I div con role="region" hanno bisogno di un nome?

SÌ. Una regione di riferimento dovrebbe avere un nome accessibile, in genere aria-labelledby o aria-label, in modo che gli utenti sappiano a cosa serve la regione.

Articoli correlati