Fra og med Vortex 2.0.11 finnes det en komponent som setter inn en automatisk generert innholdsfortegnelse i et HTML-dokument, basert på overskriftene i dokumentet (h2 og h3). Innholdsfortegnelsen består av hoppelenker til de aktuelle overskriftene i dokumentet.
På det stedet i dokumentet du ønsker at innholdsfortegnelsen skal dukke opp skriver du:
${resource:toc}
Et fornuftig sted å legge innholdsfortegnelsen er rett under hovedoverskriften <h1> i dokumentet.
<h2 id="nye-komponenter">Nye komponenter</h2>
Det er viktig at id-attributtet har en unik verdi (internt i dokumentet). Id-attributter legger du inn på riktig sted i dokumentet ved å redigere HTML-dokumentet som tekst. En slik lenke vil også fungere i nettlesere der brukeren har skrudd av Javascript.
Komponenten går igjennom alle overskrifter av typen <h2> og <h3> i dokumentet, og genererer en unik identifikator til overskriften basert på hvor i dokumentet den befinner seg. Typisk får første overskrift i dokumentet id="toc1", mens andre overskrift får id="toc2". Hvis overskriften har et id-attributt fra før, benytter innholdsfortegnelsen dette, fremfor å generere en ny identifikator basert på plassering i dokumentet.
Komponenten bruker Javascript. For brukere som har skrudd av Javascript i nettleseren, så dukker rett og slett ikke innholdsfortegnelsen opp. Det er planlagt å lage en versjon av komponenten som ikke trenger Javascript.
Safari har manglende støtte for noen av de underliggende funksjonene som Javascript biblioteket getElementsByTagNames benytter seg av. Det medfører at i Safari så blir innholdsfortegnelsen kun basert på overskrifter av typen <h2> i dokumentet.
Hvis det er lagt inn et anker (ikke "id") på overskriften på denne måten:
<h2><a name="prosjekter">Oversikt over prosjekter</a><h2>
klarer foreløpig ikke komponenten å lage en klikkbar hopplenke til den overskriften i dokumentet.
Løsingen er å fjerne ankeret fra overskriften og heller legge det inn som en id på overskriften:
<h2 id="prosjekter">Oversikt over prosjekter<h2>