Contents list
A short list of links near the top of a long page. It helps people jump to the answer they need without reading every section.
Example
Who can apply?
Check the eligibility requirements before you start.
Documents you need
Prepare the documents listed for this service.
Fees and processing time
Review the fee and expected processing time.
Show HTML
<nav class="ag-contents" aria-labelledby="contents-example-title">
<h2 class="ag-contents__title" id="contents-example-title">On this page</h2>
<ol class="ag-contents__list">
<li><a href="#contents-example-eligibility">Who can apply?</a></li>
<li><a href="#contents-example-documents">Documents you need</a></li>
<li><a href="#contents-example-fees">Fees and processing time</a></li>
</ol>
</nav>
<section id="contents-example-eligibility">
<h2>Who can apply?</h2>
<p>Check the eligibility requirements before you start.</p>
</section>
<section id="contents-example-documents">
<h2>Documents you need</h2>
<p>Prepare the documents listed for this service.</p>
</section>
<section id="contents-example-fees">
<h2>Fees and processing time</h2>
<p>Review the fee and expected processing time.</p>
</section>How to use it
- Place the navigation near the top of a long page, after the page introduction and before the first content section.
-
Give the navigation a short heading such as “On this page” and connect it with
aria-labelledby. -
Use a real link for every section and make each link's
hrefmatch a unique heading or sectionid. - Use meaningful link text that makes sense out of context. Keep the list short and in the same order as the content.
- The links are ordinary HTML anchors, so they work without JavaScript. No script or additional JavaScript dependency is needed.
When to use
Use it on long questions-and-answers pages, fee pages with several tables, and service pages with multiple sections. For a short page, let people read from top to bottom without adding extra navigation.
Accessibility
- The
navelement creates a navigation landmark, named by its visible heading. - Use unique IDs and ensure every link points to an existing target.
- Do not rely on colour alone: links remain underlined, with clear wording and visible keyboard focus.