Indice e breadcrumb

Obiettivo: dare a una pagina lunga un elenco «in questa pagina» e mostrare ai visitatori dove si trovano.
Tempo: 4 minuti
Serve: una pagina con diversi titoli

Passaggi

  1. Ancorate prima i vostri titoli. Un indice elenca i blocchi Header che hanno un Anchor ID; i titoli senza gli sono invisibili.
  2. Modificate ogni blocco Header che volete elencare e compilate Anchor ID. Usate parole minuscole unite da trattini: how-we-run-a-project.
  3. Selezionate Add Block, poi TOC. Impostate il TOC Title: On this page è la convenzione.
  4. Mettetelo verso l'alto della pagina, sopra il contenuto che descrive.
  5. Selezionate Add Block, poi Breadcrumb. Impostate l'Home label e decidete se includere il Current page item.
  6. Salvate e controllate il risultato.
Header block form showing the text, level, and anchor ID fields.
TOC block form showing the optional title field.
Breadcrumb block form showing the home label and current page item settings.
Public page showing an on-this-page list of anchored headings above a breadcrumb trail.

L'indice si costruisce, non si scrive

L'elenco non lo scrivete mai voi. Il blocco TOC legge i blocchi Header ancorati della stessa pagina e costruisce l'elenco da quelli, nell'ordine della pagina.

Significa che non invecchia mai: rinominate un titolo e la voce lo segue; aggiungete una sezione e compare; togliete l'ancora e sparisce. Significa anche che un TOC vuoto non è un blocco rotto: è una pagina senza titoli ancorati.

Note

  • Un'ancora è anche una destinazione di link. Una volta che un titolo ne ha una, potete collegarvi direttamente a quella sezione da qualsiasi punto.
  • Tenete stabili le ancore. Cambiarne una rompe ogni link che qualcuno ha salvato verso quella sezione: la stessa regola dello slug di una pagina.
  • Un TOC su una pagina breve è rumore. Se chi legge vede tutti i titoli senza scorrere, l'elenco ripete quello che è già visibile.
  • I breadcrumb derivano dal percorso della pagina, quindi riflettono dove la pagina si trova davvero. Se la traccia sembra sbagliata, è l'indirizzo della pagina da sistemare.
  • I titoli annidati dentro card e altri blocchi non vengono elencati. Il TOC è una mappa delle sezioni della pagina, non di ogni titolo presente.
Avanti: costruire un menu di navigazione